alepha@docs:~/docs/cli$
cat 1-installation.md
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

This initializes your project 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    "verify": "alepha verify"6  }7}

Run them with your package manager:

npm run dev

#Requirements

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

Check your version:

bash
node --version
On This Page
No headings found...
ready
mainTypeScript
UTF-8cli_installation.md