forinda/kickjs-examples-archive

kickjs-add-adapter

Use when wiring a single-concern lifecycle integration (Swagger, DevTools, Sentry, Redis client).

Langue du texte source : anglais

kickjs-add-module

Use when the user asks to add a new feature module (controller + service + repo + DTOs).

Langue du texte source : anglais

kickjs-add-plugin

Use when scaffolding a feature that bundles modules + DI + middleware + adapters together (auth, monitoring suite, multi-tenant scaffolding).

Langue du texte source : anglais

kickjs-bootstrap-export

Use when HMR is silently doing full restarts on every save, or createTestApp can't find the app handle.

Langue du texte source : anglais

kickjs-cli-commands-cheatsheet

Use as a quick reference for the most common kick CLI workflows — scaffolding, dev/build/start, generation, inspection.

Langue du texte source : anglais

kickjs-cli-plugin

Use when adding a kick <name> command, a kick g <name> generator, or a typegen emitter to this project or a package it ships.

Langue du texte source : anglais

kickjs-context-contributor

Use when a middleware's only job is to set ctx values consumed elsewhere — replace with defineHttpContextDecorator (HTTP) or defineContextDecorator (transport-agnostic).

Langue du texte source : anglais

kickjs-deny-list

Patterns to refuse outright when the user asks for them — they break v4 invariants.

Langue du texte source : anglais

kickjs-deploy

Use when deploying this app — a Node host or Docker, Netlify, Vercel or Cloudflare Workers — or when an API route returns the SPA shell, the platform build fails, or the function is missing from a deploy.

Langue du texte source : anglais

kickjs-docs-lookup

Use FIRST when unsure about any KickJS API, option, or behaviour — before guessing from memory or inferring from surrounding code.

Langue du texte source : anglais

kickjs-env-wiring-check

Use when ConfigService.get('SOME_KEY') returns undefined or @Value silently falls back to process.env.

Langue du texte source : anglais

kickjs-guard-vs-middleware-vs-contributor

Use when adding auth checks, request-scoped values, or anything "before the handler" — picks between a guard, a middleware, and a context contributor.

Langue du texte source : anglais

kickjs-query-parsing-list-endpoint

Use when adding a paginated/filterable list route — emit ctx.qs + ctx.paginate with an allow-list.

Langue du texte source : anglais

kickjs-refresh-agent-docs

Use after a KickJS version bump to sync the .agents/ docs with the latest CLI templates.

Langue du texte source : anglais

kickjs-route-flags

Use when a fact about a route (public, CSRF-exempt, unmetered, expose as a tool) has to be read by auth, CSRF, rate limiting, OpenAPI or MCP — instead of repeating it as paths in each consumer.

Langue du texte source : anglais

kickjs-thin-entry-file

Use when src/index.ts is accumulating module/middleware/plugin/adapter literals.

Langue du texte source : anglais

kickjs-use-asset-manager

Use when code reads template files / JSON fixtures via fs.readFile + path arithmetic — switch to assets.<ns>.<key>() and the kick.config.ts assetMap.

Langue du texte source : anglais

kickjs-write-controller-test

Use when adding a Vitest test that exercises an HTTP route or DI graph.

Langue du texte source : anglais

kickjs-add-adapter

Use when wiring a single-concern lifecycle integration (Swagger, DevTools, Sentry, Redis client).

Langue du texte source : anglais

kickjs-add-module

Use when the user asks to add a new feature module (controller + service + repo + DTOs).

Langue du texte source : anglais

kickjs-add-plugin

Use when scaffolding a feature that bundles modules + DI + middleware + adapters together (auth, monitoring suite, multi-tenant scaffolding).

Langue du texte source : anglais

kickjs-bootstrap-export

Use when HMR is silently doing full restarts on every save, or createTestApp can't find the app handle.

Langue du texte source : anglais

kickjs-cli-commands-cheatsheet

Use as a quick reference for the most common kick CLI workflows — scaffolding, dev/build/start, generation, inspection.

Langue du texte source : anglais

kickjs-cli-plugin

Use when adding a kick <name> command, a kick g <name> generator, or a typegen emitter to this project or a package it ships.

Langue du texte source : anglais

kickjs-context-contributor

Use when a middleware's only job is to set ctx values consumed elsewhere — replace with defineHttpContextDecorator (HTTP) or defineContextDecorator (transport-agnostic).

Langue du texte source : anglais

kickjs-deny-list

Patterns to refuse outright when the user asks for them — they break v4 invariants.

Langue du texte source : anglais

kickjs-deploy

Use when deploying this app — a Node host or Docker, Netlify, Vercel or Cloudflare Workers — or when an API route returns the SPA shell, the platform build fails, or the function is missing from a deploy.

Langue du texte source : anglais

kickjs-docs-lookup

Use FIRST when unsure about any KickJS API, option, or behaviour — before guessing from memory or inferring from surrounding code.

Langue du texte source : anglais

kickjs-env-wiring-check

Use when ConfigService.get('SOME_KEY') returns undefined or @Value silently falls back to process.env.

Langue du texte source : anglais

kickjs-guard-vs-middleware-vs-contributor

Use when adding auth checks, request-scoped values, or anything "before the handler" — picks between a guard, a middleware, and a context contributor.

Langue du texte source : anglais

kickjs-query-parsing-list-endpoint

Use when adding a paginated/filterable list route — emit ctx.qs + ctx.paginate with an allow-list.

Langue du texte source : anglais

kickjs-refresh-agent-docs

Use after a KickJS version bump to sync the .agents/ docs with the latest CLI templates.

Langue du texte source : anglais

kickjs-route-flags

Use when a fact about a route (public, CSRF-exempt, unmetered, expose as a tool) has to be read by auth, CSRF, rate limiting, OpenAPI or MCP — instead of repeating it as paths in each consumer.

Langue du texte source : anglais

kickjs-thin-entry-file

Use when src/index.ts is accumulating module/middleware/plugin/adapter literals.

Langue du texte source : anglais

kickjs-use-asset-manager

Use when code reads template files / JSON fixtures via fs.readFile + path arithmetic — switch to assets.<ns>.<key>() and the kick.config.ts assetMap.

Langue du texte source : anglais

kickjs-write-controller-test

Use when adding a Vitest test that exercises an HTTP route or DI graph.

Langue du texte source : anglais

kickjs-add-adapter

Use when wiring a single-concern lifecycle integration (Swagger, DevTools, Sentry, Redis client).

Langue du texte source : anglais

kickjs-add-module

Use when the user asks to add a new feature module (controller + service + repo + DTOs).

Langue du texte source : anglais

kickjs-add-plugin

Use when scaffolding a feature that bundles modules + DI + middleware + adapters together (auth, monitoring suite, multi-tenant scaffolding).

Langue du texte source : anglais

kickjs-bootstrap-export

Use when HMR is silently doing full restarts on every save, or createTestApp can't find the app handle.

Langue du texte source : anglais