create-lacis

create-lacis is the official scaffolding CLI. It sets up a new Lacis project with the right structure, entry point, and dependencies for your target platform.

Usage

npm create lacis@latest

Prompts

The CLI asks three questions:

1. Project name — becomes the directory name (lowercase letters, numbers, -, _, .)
2. Platform — Node.js, Bun, Vercel, or Netlify
3. Validation library — Zod, Valibot, ArkType, or none

Generated structure

Node.js

• Directorymy-app/

  • Directoryroutes/

    • index.ts
  • server.ts
  • package.json
  • tsconfig.json
  • .gitignore

// package.json scripts
{
  "dev": "tsx watch server.ts",
  "build": "lacis build"
}

Bun

• Directorymy-app/

  • Directoryroutes/

    • index.ts
  • server.ts
  • package.json
  • tsconfig.json
  • .gitignore

// package.json scripts
{
  "dev": "bun --watch server.ts",
  "build": "lacis build"
}

Vercel

• Directorymy-app/

  • Directoryroutes/

    • index.ts
  • Directoryapi/

    • slug.ts
  • vercel.json
  • package.json
  • tsconfig.json
  • .gitignore

// package.json scripts
{
  "dev": "lacis dev",
  "build": "lacis build"
}

Netlify

• Directorymy-app/

  • Directoryroutes/

    • index.ts
  • Directorynetlify/

    • Directoryfunctions/

      • api.ts
  • netlify.toml
  • package.json
  • tsconfig.json
  • .gitignore

// package.json scripts
{
  "dev": "lacis dev",
  "build": "lacis build"
}

Validator dependencies

Each validator choice adds the appropriate packages to dependencies:

Choice	Packages added
Zod	zod, zod-to-json-schema
Valibot	valibot, @valibot/to-json-schema
ArkType	arktype
None	—

The converter packages (zod-to-json-schema, @valibot/to-json-schema) are needed for OpenAPI spec generation. If you don’t plan to use OpenAPI, you can remove them.