Environment Setup

# {frontmatter.title}

Before developing the resume generation tool, you need to configure the development environment. This chapter will guide you through all necessary environment configurations.

Install Node.js

Visit the Node.js official website to download the latest LTS version: https://nodejs.org/
Or install using nvm (recommended):

   # Install nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

   # Install Node.js
   nvm install --lts
   nvm use --lts

Verify installation:

   node -v
   npm -v

Install pnpm

pnpm is a fast, disk space efficient package manager:

npm install -g pnpm

Verify installation:
```bash
pnpm -v

## Install Puppeteer Browser

Puppeteer needs to download the Chromium browser:

```bash
npx puppeteer browsers install chrome

::: tip
This command only needs to be executed once per computer. It downloads a standalone Chromium browser and won't affect the browser already installed on your system.
:::

## Configure VS Code

1. Install VS Code:
   https://code.visualstudio.com/

2. Install necessary extensions:
   - Vue - Official (Vue Language Features)
   - TypeScript Vue Plugin (Volar)
   - ESLint

## Verify Environment

Make sure the following commands run normally:

```bash
node -v      # Should show v18.x.x or higher
pnpm -v      # Should show pnpm version number

## Common Issues

### 1. Node.js version too low

Make sure Node.js version >= 18, Vite 5 and Vue 3.4 require a newer Node.js version.

### 2. Puppeteer download failed

If Chromium download is slow, you can set a proxy:

```bash
HTTP_PROXY=http://proxy.example.com:8080 npx puppeteer browsers install chrome

### 3. pnpm installation failed

If global installation of pnpm fails, you can try:

```bash
# Use corepack (built into Node.js)
corepack enable
corepack prepare pnpm@latest --activate

## Next Step

After the environment is configured, we can start [creating the project](./01-Create_Project.mdx).