alepha@docs:~/docs/cli$
cat 1-installation.md | pretty
1 min read
Last commit:

#Installation

The Alepha CLI is bundled inside the alepha package. No separate installation required.

#Getting Started

Create a new project:

npx alepha init my-app

This scaffolds a full-stack project — API, React web module, and Tailwind — and adds alepha as a dependency. From then on, run commands from your project directory:

npx alepha dev
npx alepha build

Lost? Run npx alepha -h to see every command at your disposal. It's the cheat sheet you didn't know you needed.

#Why Not Global Install?

Global installation (npm install -g alepha) is not recommended. When working on multiple projects, each may require a different Alepha version. Using npx or project-local scripts ensures each project uses its own version.

#Using npm Scripts

After alepha init, your package.json includes ready-to-use scripts:

json
 1{ 2  "scripts": { 3    "dev": "alepha dev", 4    "build": "alepha build", 5    "test": "alepha test", 6    "lint": "alepha lint", 7    "typecheck": "alepha typecheck", 8    "verify": "alepha verify" 9  }10}

Run them with your package manager:

npm run dev

#Requirements

  • Node.js 22+ — Alepha uses modern JavaScript features

Check your version:

bash
node --version