forinda/kick-fullstack-netlify

ملف forinda

آخر نشاط مصدر مسجل: ١٨ سبتمبر ٢٠٢٦ في ١١:٥٢

آخر تحديث لفهرس SkillsMP: ١٧ أكتوبر ٢٠٢٦ في ٠٠:٠٩

skills مجمعة: ٣٠

نجوم GitHub: ٠
تفرعات GitHub: ٠

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

# kick-fullstack Fullstack KickJS workspace — typed end to end. | Package | What | | --------- | ----------------------------------------------------------------- | | `server/` | KickJS API (decorators, DI, `kick dev` with typegen watch) | | `web/` | Vite + React, typed against the API via `@forinda/kickjs-client` | ## Develop ```bash pnpm install pnpm dev # server (kick dev) + web (vite), in parallel ``` Server: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies `/api`). ## The type loop 1. Server handlers **return** their payloads (`return this.service.greet(...)`). 2. `kick typegen` emits `server/.kickjs/types/kick__client.d.ts` — the flat route map with every response type resolved to a literal shape. 3. `web/tsconfig.json` lists that file in `types`, so `KickClientApi` is ambient — no import, no bridge file. 4. `web/src/api.ts`'s `createClient<KickClientApi.Api>` types every call site. Because the map holds resolved types rather than references to controllers, `web` never compiles server source: no `experimentalDecorators`, no path aliases into `server/src`. Rename a field in `server/src/modules/hello/hello.service.ts` → `web/src/App.tsx` stops compiling. That's the point. ### Keeping the map fresh `server/.kickjs/types/kick__client.d.ts` is generated, and `web` reads it as an ambient type package. Two things follow. **It is not refreshed by `kick dev`.** Resolving it builds a whole TypeScript program over the server, which is a build-step cost rather than a per-save one, so a renamed response field surfaces on the next `kick typegen` rather than on save. Everything else in `.kickjs/types` still updates on save. Add `kick typegen --check` to CI and a stale map fails the build. **It needs a compiler API.** TypeScript 7 ships none, so `server` depends on `@typescript/typescript6`. Remove it and typegen skips this one file, saying so; `web` then reports `TS2688` because the file it lists in `types` is gone. ### The other way to wire it A `types` entry says "this is a global type package", which is what the map is, and it fails loudly when the file is missing. If you would rather it be quiet when absent — say, a repo where the map is not always generated — use `include` instead: ```json { "include": ["src", "../server/.kickjs/types/kick__client.d.ts"] } ``` That tolerates the file not existing, at the cost of `KickClientApi` silently not resolving. Note `types` replaces TypeScript's automatic `@types` inclusion, so if you add entries there, list the ones you rely on too (`"types": ["node", "../server/.kickjs/types/kick__client"]`). Or skip the global entirely — the same file exports the type: ```ts import type { Api } from '../../server/.kickjs/types/kick__client' export const api = createClient<Api>({ baseUrl: '/api/v1' }) ``` Docs: https://kickjs.app/guide/typed-client.html

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

مطوّرو البرمجيات المهن الحاسوبية الأخرى محللو ضمان جودة البرمجيات والمختبرون مديرو الشبكات وأنظمة الحاسوب

٤ فئات مهنية · 100% مصنفة

skill

المهنة

الوصف

آخر تحديث

kickjs-add-adapter

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-add-module

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-add-plugin

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-bootstrap-export

مديرو الشبكات وأنظمة الحاسوب

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-cli-commands-cheatsheet

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

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).

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-deny-list

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-docs-lookup

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-env-wiring-check

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

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.

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-query-parsing-list-endpoint

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-refresh-agent-docs

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-thin-entry-file

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

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.

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-write-controller-test

محللو ضمان جودة البرمجيات والمختبرون

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-add-adapter

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-add-module

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-add-plugin

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-bootstrap-export

مديرو الشبكات وأنظمة الحاسوب

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-cli-commands-cheatsheet

المهن الحاسوبية الأخرى

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

لغة النص الأصلي: الإنجليزية

2026-09-18

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).

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-deny-list

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-docs-lookup

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-env-wiring-check

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

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.

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-query-parsing-list-endpoint

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-refresh-agent-docs

المهن الحاسوبية الأخرى

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

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-thin-entry-file

مطوّرو البرمجيات

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

لغة النص الأصلي: الإنجليزية

2026-09-18

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.

لغة النص الأصلي: الإنجليزية

2026-09-18

kickjs-write-controller-test

محللو ضمان جودة البرمجيات والمختبرون

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

لغة النص الأصلي: الإنجليزية

2026-09-18

عرض ٣٠ من أصل ٣٠ skills مجمعة.

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/forinda/kick-fullstack-netlify.