create-lacis

create-lacis est le CLI de scaffolding officiel. Il configure un nouveau projet Lacis avec la bonne structure, le point d’entrée et les dépendances pour votre plateforme cible.

Utilisation

npm create lacis@latest

Questions posées

Le CLI pose trois questions :

1. Nom du projet — devient le nom du répertoire (lettres minuscules, chiffres, -, _, .)
2. Plateforme — Node.js, Bun, Vercel ou Netlify
3. Bibliothèque de validation — Zod, Valibot, ArkType ou aucune

Structure générée

Node.js

• Répertoiremy-app/

  • Répertoireroutes/

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

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

Bun

• Répertoiremy-app/

  • Répertoireroutes/

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

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

Vercel

• Répertoiremy-app/

  • Répertoireroutes/

    • index.ts
  • Répertoireapi/

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

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

Netlify

• Répertoiremy-app/

  • Répertoireroutes/

    • index.ts
  • Répertoirenetlify/

    • Répertoirefunctions/

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

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

Dépendances de validation

Chaque choix de validateur ajoute les packages appropriés aux dependencies :

Choix	Packages ajoutés
Zod	zod, zod-to-json-schema
Valibot	valibot, @valibot/to-json-schema
ArkType	arktype
Aucun	—

Les packages convertisseurs (zod-to-json-schema, @valibot/to-json-schema) sont nécessaires pour la génération de spec OpenAPI. Si vous ne prévoyez pas d’utiliser OpenAPI, vous pouvez les supprimer.