Curvea

CLI

curvea new

Creates a new Curvea Engine project.

Usage

curvea new my-site

If the name is omitted, Curvea CLI prompts for it.

Prompts

The scaffolder asks:

Project name:
Use Tailwind CSS? (Y/n):
Include Lucide helper? (y/N):
Choose template (1/2):

Templates are:

1) Basic website
2) Blank

Project names may contain letters, numbers, dashes, and underscores.

Generated project metadata

The generated package.json is private, records the Curvea Engine project version 1, declares @curvea/cli using the running CLI package version, and adds:

{
  "scripts": {
    "dev": "curvea dev",
    "build": "curvea build"
  }
}

With Curvea CLI 0.1.1, newly generated projects therefore declare:

{
  "devDependencies": {
    "@curvea/cli": "^0.1.1"
  }
}

The scaffolder creates the standard source folders, public, dist, package.json, curvea.config.json, and .gitignore. dist and node_modules are ignored by Git.

Optional setup

If Tailwind is selected, Curvea CLI declares Tailwind v4 dependencies, ensures the Tailwind import exists in src/assets/css/app.css, and installs the required packages.

If Lucide is selected, Curvea CLI declares and installs Lucide and creates src/assets/js/lucide.js if needed.

Next steps

The command finishes with the standard project workflow:

cd my-site
npm install
npm run dev
npm run build