Installation¶

Requirements¶

npm install tempest-express-sdk tempest-db-js express zod

Peer dependencies

tempest-db-js is a required peer dependency (the database layer). For authentication, also install the optional peers:

npm install bcryptjs jsonwebtoken

Without them the SDK still imports fine — the error only surfaces when you instantiate PasswordUtils / JWTUtils.

The CLI scaffolds a complete, layered Express service with Swagger + Redoc:

npx tempest-express new my-service
cd my-service
npm install
cp .env.example .env
npm run dev

Command	What it does
`tempest-express new <name>`	Create a complete service
`tempest-express generate <Name>`	Scaffold a CRUD resource (model→router)
`tempest-express secret [--bytes 32]`	Generate a random secret (JWT/token)
`tempest-express docker-compose`	Write a `docker-compose.yml` (Postgres + Redis)
`tempest-express db`	Migration guidance (via `tempest-db-js`)
`tempest-express lint [--dir .]`	Run the Biome check in a project
`tempest-express config [--dir .]`	Print the resolved base settings (reads `.env`)
`tempest-express user --email <e> --password <p> [--admin]`	Print a ready-to-insert user record (bcrypt hash)

The SDK and template use an @ alias pointing at src, with no .js suffix:

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "Bundler",
    "strict": true,
    "paths": { "@/*": ["./src/*"] }
  }
}