Installation

Full, Zero‑Setup Guide

Download & Extract

You received a folder/zip. After extracting, you will have a structure like:

- - .gitignore
  - README.md
  - components.json
  - eslint.config.js
  - index.html
  - package.json
  - tsconfig.app.json
  - tsconfig.json
  - tsconfig.node.json
  - vite.config.ts
  - yarn.lock
- README.md

All commands below are run inside /project unless stated otherwise.

Install Node.js

If you don’t have Node.js installed:

Windows / macOS (easy):
1. Download and install the latest LTS version from nodejs.org .
2. Close & reopen your terminal after install.
macOS (Homebrew, optional):
```
brew install node@20
```

Linux (nvm, recommended):


# Install nvm (Node Version Manager):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# Restart terminal, then:
nvm install --lts

Verify installation:


node -v
npm -v

Go to the project folder


cd /path/to/YourDownload/project

Install dependencies

Option A — npm (recommended for zero-setup):


npm install

Option B — Yarn Classic (optional):


# Install Yarn Classic globally (once)
npm i -g yarn@1
# Then in the project:
yarn

Run the development server

npm:


npm run dev

Yarn:


yarn dev

Open the app in your browser:


http://localhost:5173