tribunal-kit 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (226) hide show
  1. package/.agent/ARCHITECTURE.md +99 -99
  2. package/.agent/GEMINI.md +52 -52
  3. package/.agent/agents/accessibility-reviewer.md +187 -220
  4. package/.agent/agents/ai-code-reviewer.md +199 -233
  5. package/.agent/agents/backend-specialist.md +215 -238
  6. package/.agent/agents/code-archaeologist.md +161 -181
  7. package/.agent/agents/database-architect.md +184 -207
  8. package/.agent/agents/debugger.md +191 -218
  9. package/.agent/agents/dependency-reviewer.md +103 -136
  10. package/.agent/agents/devops-engineer.md +218 -238
  11. package/.agent/agents/documentation-writer.md +201 -221
  12. package/.agent/agents/explorer-agent.md +160 -180
  13. package/.agent/agents/frontend-reviewer.md +160 -194
  14. package/.agent/agents/frontend-specialist.md +248 -237
  15. package/.agent/agents/game-developer.md +48 -52
  16. package/.agent/agents/logic-reviewer.md +116 -149
  17. package/.agent/agents/mobile-developer.md +200 -223
  18. package/.agent/agents/mobile-reviewer.md +162 -195
  19. package/.agent/agents/orchestrator.md +181 -211
  20. package/.agent/agents/penetration-tester.md +157 -174
  21. package/.agent/agents/performance-optimizer.md +183 -203
  22. package/.agent/agents/performance-reviewer.md +178 -211
  23. package/.agent/agents/product-manager.md +142 -162
  24. package/.agent/agents/product-owner.md +6 -25
  25. package/.agent/agents/project-planner.md +142 -162
  26. package/.agent/agents/qa-automation-engineer.md +225 -242
  27. package/.agent/agents/security-auditor.md +174 -194
  28. package/.agent/agents/seo-specialist.md +193 -213
  29. package/.agent/agents/sql-reviewer.md +161 -194
  30. package/.agent/agents/supervisor-agent.md +184 -203
  31. package/.agent/agents/swarm-worker-contracts.md +17 -17
  32. package/.agent/agents/swarm-worker-registry.md +46 -46
  33. package/.agent/agents/test-coverage-reviewer.md +160 -193
  34. package/.agent/agents/test-engineer.md +0 -21
  35. package/.agent/agents/type-safety-reviewer.md +175 -208
  36. package/.agent/patterns/generator.md +9 -9
  37. package/.agent/patterns/inversion.md +12 -12
  38. package/.agent/patterns/pipeline.md +9 -9
  39. package/.agent/patterns/reviewer.md +13 -13
  40. package/.agent/patterns/tool-wrapper.md +9 -9
  41. package/.agent/rules/GEMINI.md +63 -63
  42. package/.agent/scripts/compress_skills.py +167 -0
  43. package/.agent/scripts/consolidate_skills.py +173 -0
  44. package/.agent/scripts/deep_compress.py +202 -0
  45. package/.agent/scripts/minify_context.py +80 -0
  46. package/.agent/scripts/security_scan.py +1 -1
  47. package/.agent/scripts/strip_tribunal.py +41 -0
  48. package/.agent/skills/agent-organizer/SKILL.md +92 -126
  49. package/.agent/skills/agentic-patterns/SKILL.md +0 -70
  50. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +126 -160
  51. package/.agent/skills/api-patterns/SKILL.md +123 -215
  52. package/.agent/skills/api-security-auditor/SKILL.md +143 -177
  53. package/.agent/skills/app-builder/SKILL.md +326 -50
  54. package/.agent/skills/app-builder/templates/SKILL.md +13 -15
  55. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +16 -16
  56. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +22 -22
  57. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +18 -18
  58. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +20 -20
  59. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +17 -17
  60. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +18 -18
  61. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +21 -21
  62. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +19 -19
  63. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +26 -26
  64. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +26 -26
  65. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +19 -19
  66. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +18 -18
  67. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +20 -20
  68. package/.agent/skills/appflow-wireframe/SKILL.md +87 -121
  69. package/.agent/skills/architecture/SKILL.md +82 -252
  70. package/.agent/skills/authentication-best-practices/SKILL.md +139 -173
  71. package/.agent/skills/bash-linux/SKILL.md +120 -154
  72. package/.agent/skills/behavioral-modes/SKILL.md +8 -69
  73. package/.agent/skills/brainstorming/SKILL.md +428 -104
  74. package/.agent/skills/building-native-ui/SKILL.md +143 -174
  75. package/.agent/skills/clean-code/SKILL.md +323 -360
  76. package/.agent/skills/code-review-checklist/SKILL.md +0 -62
  77. package/.agent/skills/config-validator/SKILL.md +107 -141
  78. package/.agent/skills/csharp-developer/SKILL.md +468 -528
  79. package/.agent/skills/database-design/SKILL.md +104 -369
  80. package/.agent/skills/deployment-procedures/SKILL.md +111 -145
  81. package/.agent/skills/devops-engineer/SKILL.md +295 -332
  82. package/.agent/skills/devops-incident-responder/SKILL.md +79 -113
  83. package/.agent/skills/doc.md +5 -5
  84. package/.agent/skills/documentation-templates/SKILL.md +19 -63
  85. package/.agent/skills/edge-computing/SKILL.md +123 -157
  86. package/.agent/skills/extract-design-system/SKILL.md +100 -134
  87. package/.agent/skills/framer-motion-expert/SKILL.md +111 -855
  88. package/.agent/skills/frontend-design/SKILL.md +151 -499
  89. package/.agent/skills/game-design-expert/SKILL.md +71 -105
  90. package/.agent/skills/game-engineering-expert/SKILL.md +88 -122
  91. package/.agent/skills/geo-fundamentals/SKILL.md +89 -124
  92. package/.agent/skills/github-operations/SKILL.md +279 -314
  93. package/.agent/skills/gsap-expert/SKILL.md +119 -826
  94. package/.agent/skills/i18n-localization/SKILL.md +104 -138
  95. package/.agent/skills/intelligent-routing/SKILL.md +159 -127
  96. package/.agent/skills/lint-and-validate/SKILL.md +8 -52
  97. package/.agent/skills/llm-engineering/SKILL.md +344 -357
  98. package/.agent/skills/local-first/SKILL.md +120 -154
  99. package/.agent/skills/mcp-builder/SKILL.md +84 -118
  100. package/.agent/skills/mobile-design/SKILL.md +213 -219
  101. package/.agent/skills/motion-engineering/SKILL.md +184 -0
  102. package/.agent/skills/nextjs-react-expert/SKILL.md +99 -698
  103. package/.agent/skills/nodejs-best-practices/SKILL.md +498 -559
  104. package/.agent/skills/observability/SKILL.md +293 -330
  105. package/.agent/skills/parallel-agents/SKILL.md +88 -122
  106. package/.agent/skills/performance-profiling/SKILL.md +217 -254
  107. package/.agent/skills/plan-writing/SKILL.md +84 -118
  108. package/.agent/skills/platform-engineer/SKILL.md +89 -123
  109. package/.agent/skills/playwright-best-practices/SKILL.md +128 -162
  110. package/.agent/skills/powershell-windows/SKILL.md +112 -146
  111. package/.agent/skills/python-patterns/SKILL.md +7 -35
  112. package/.agent/skills/python-pro/SKILL.md +148 -754
  113. package/.agent/skills/react-specialist/SKILL.md +123 -827
  114. package/.agent/skills/readme-builder/SKILL.md +15 -85
  115. package/.agent/skills/realtime-patterns/SKILL.md +269 -304
  116. package/.agent/skills/red-team-tactics/SKILL.md +10 -51
  117. package/.agent/skills/rust-pro/SKILL.md +623 -701
  118. package/.agent/skills/seo-fundamentals/SKILL.md +120 -154
  119. package/.agent/skills/server-management/SKILL.md +156 -190
  120. package/.agent/skills/shadcn-ui-expert/SKILL.md +172 -206
  121. package/.agent/skills/skill-creator/SKILL.md +18 -58
  122. package/.agent/skills/sql-pro/SKILL.md +579 -633
  123. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +28 -68
  124. package/.agent/skills/swiftui-expert/SKILL.md +142 -176
  125. package/.agent/skills/systematic-debugging/SKILL.md +84 -118
  126. package/.agent/skills/tailwind-patterns/SKILL.md +516 -576
  127. package/.agent/skills/tdd-workflow/SKILL.md +103 -137
  128. package/.agent/skills/test-result-analyzer/SKILL.md +33 -73
  129. package/.agent/skills/testing-patterns/SKILL.md +512 -573
  130. package/.agent/skills/trend-researcher/SKILL.md +30 -71
  131. package/.agent/skills/ui-ux-pro-max/SKILL.md +0 -41
  132. package/.agent/skills/ui-ux-researcher/SKILL.md +51 -91
  133. package/.agent/skills/vue-expert/SKILL.md +127 -866
  134. package/.agent/skills/vulnerability-scanner/SKILL.md +354 -269
  135. package/.agent/skills/web-accessibility-auditor/SKILL.md +159 -193
  136. package/.agent/skills/web-design-guidelines/SKILL.md +17 -61
  137. package/.agent/skills/webapp-testing/SKILL.md +111 -145
  138. package/.agent/skills/whimsy-injector/SKILL.md +58 -132
  139. package/.agent/skills/workflow-optimizer/SKILL.md +28 -68
  140. package/.agent/workflows/api-tester.md +151 -151
  141. package/.agent/workflows/audit.md +127 -138
  142. package/.agent/workflows/brainstorm.md +110 -110
  143. package/.agent/workflows/changelog.md +112 -112
  144. package/.agent/workflows/create.md +124 -124
  145. package/.agent/workflows/debug.md +165 -189
  146. package/.agent/workflows/deploy.md +180 -189
  147. package/.agent/workflows/enhance.md +128 -151
  148. package/.agent/workflows/fix.md +114 -135
  149. package/.agent/workflows/generate.md +12 -4
  150. package/.agent/workflows/migrate.md +160 -160
  151. package/.agent/workflows/orchestrate.md +168 -168
  152. package/.agent/workflows/performance-benchmarker.md +114 -123
  153. package/.agent/workflows/plan.md +173 -173
  154. package/.agent/workflows/preview.md +80 -80
  155. package/.agent/workflows/refactor.md +161 -183
  156. package/.agent/workflows/review-ai.md +101 -129
  157. package/.agent/workflows/review.md +116 -116
  158. package/.agent/workflows/session.md +94 -94
  159. package/.agent/workflows/status.md +79 -79
  160. package/.agent/workflows/strengthen-skills.md +138 -139
  161. package/.agent/workflows/swarm.md +179 -179
  162. package/.agent/workflows/test.md +189 -211
  163. package/.agent/workflows/tribunal-backend.md +93 -113
  164. package/.agent/workflows/tribunal-database.md +94 -115
  165. package/.agent/workflows/tribunal-frontend.md +95 -118
  166. package/.agent/workflows/tribunal-full.md +92 -133
  167. package/.agent/workflows/tribunal-mobile.md +94 -119
  168. package/.agent/workflows/tribunal-performance.md +109 -133
  169. package/.agent/workflows/ui-ux-pro-max.md +122 -143
  170. package/package.json +1 -1
  171. package/.agent/skills/api-patterns/api-style.md +0 -42
  172. package/.agent/skills/api-patterns/auth.md +0 -24
  173. package/.agent/skills/api-patterns/documentation.md +0 -26
  174. package/.agent/skills/api-patterns/graphql.md +0 -41
  175. package/.agent/skills/api-patterns/rate-limiting.md +0 -31
  176. package/.agent/skills/api-patterns/response.md +0 -37
  177. package/.agent/skills/api-patterns/rest.md +0 -40
  178. package/.agent/skills/api-patterns/security-testing.md +0 -122
  179. package/.agent/skills/api-patterns/trpc.md +0 -41
  180. package/.agent/skills/api-patterns/versioning.md +0 -22
  181. package/.agent/skills/app-builder/agent-coordination.md +0 -71
  182. package/.agent/skills/app-builder/feature-building.md +0 -53
  183. package/.agent/skills/app-builder/project-detection.md +0 -34
  184. package/.agent/skills/app-builder/scaffolding.md +0 -118
  185. package/.agent/skills/app-builder/tech-stack.md +0 -40
  186. package/.agent/skills/architecture/context-discovery.md +0 -43
  187. package/.agent/skills/architecture/examples.md +0 -94
  188. package/.agent/skills/architecture/pattern-selection.md +0 -68
  189. package/.agent/skills/architecture/patterns-reference.md +0 -50
  190. package/.agent/skills/architecture/trade-off-analysis.md +0 -77
  191. package/.agent/skills/brainstorming/dynamic-questioning.md +0 -360
  192. package/.agent/skills/database-design/database-selection.md +0 -43
  193. package/.agent/skills/database-design/indexing.md +0 -39
  194. package/.agent/skills/database-design/migrations.md +0 -48
  195. package/.agent/skills/database-design/optimization.md +0 -36
  196. package/.agent/skills/database-design/orm-selection.md +0 -30
  197. package/.agent/skills/database-design/schema-design.md +0 -56
  198. package/.agent/skills/frontend-design/animation-guide.md +0 -331
  199. package/.agent/skills/frontend-design/color-system.md +0 -329
  200. package/.agent/skills/frontend-design/decision-trees.md +0 -418
  201. package/.agent/skills/frontend-design/motion-graphics.md +0 -306
  202. package/.agent/skills/frontend-design/typography-system.md +0 -363
  203. package/.agent/skills/frontend-design/ux-psychology.md +0 -1116
  204. package/.agent/skills/frontend-design/visual-effects.md +0 -383
  205. package/.agent/skills/intelligent-routing/router-manifest.md +0 -65
  206. package/.agent/skills/mobile-design/decision-trees.md +0 -516
  207. package/.agent/skills/mobile-design/mobile-backend.md +0 -491
  208. package/.agent/skills/mobile-design/mobile-color-system.md +0 -420
  209. package/.agent/skills/mobile-design/mobile-debugging.md +0 -122
  210. package/.agent/skills/mobile-design/mobile-design-thinking.md +0 -357
  211. package/.agent/skills/mobile-design/mobile-navigation.md +0 -458
  212. package/.agent/skills/mobile-design/mobile-performance.md +0 -767
  213. package/.agent/skills/mobile-design/mobile-testing.md +0 -356
  214. package/.agent/skills/mobile-design/mobile-typography.md +0 -433
  215. package/.agent/skills/mobile-design/platform-android.md +0 -666
  216. package/.agent/skills/mobile-design/platform-ios.md +0 -561
  217. package/.agent/skills/mobile-design/touch-psychology.md +0 -537
  218. package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +0 -312
  219. package/.agent/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +0 -240
  220. package/.agent/skills/nextjs-react-expert/3-server-server-side-performance.md +0 -490
  221. package/.agent/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +0 -264
  222. package/.agent/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +0 -581
  223. package/.agent/skills/nextjs-react-expert/6-rendering-rendering-performance.md +0 -432
  224. package/.agent/skills/nextjs-react-expert/7-js-javascript-performance.md +0 -684
  225. package/.agent/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +0 -150
  226. package/.agent/skills/vulnerability-scanner/checklists.md +0 -121
@@ -7,14 +7,14 @@ description: Electron desktop app template principles. Cross-platform, React, Ty
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
11
  |-----------|------------|
12
- | Framework | Electron 28+ |
13
- | UI | React 19 |
14
- | Language | TypeScript |
15
- | Styling | Tailwind CSS |
16
- | Bundler | Vite + electron-builder |
17
- | IPC | Type-safe communication |
12
+ |Framework|Electron 28+|
13
+ |UI|React 19|
14
+ |Language|TypeScript|
15
+ |Styling|Tailwind CSS|
16
+ |Bundler|Vite + electron-builder|
17
+ |IPC|Type-safe communication|
18
18
 
19
19
  ---
20
20
 
@@ -40,22 +40,22 @@ project-name/
40
40
 
41
41
  ## Process Model
42
42
 
43
- | Process | Role |
43
+ |Process|Role|
44
44
  |---------|------|
45
- | Main | Node.js, system access |
46
- | Renderer | Chromium, React UI |
47
- | Preload | Bridge, context isolation |
45
+ |Main|Node.js, system access|
46
+ |Renderer|Chromium, React UI|
47
+ |Preload|Bridge, context isolation|
48
48
 
49
49
  ---
50
50
 
51
51
  ## Key Concepts
52
52
 
53
- | Concept | Purpose |
53
+ |Concept|Purpose|
54
54
  |---------|---------|
55
- | contextBridge | Safe API exposure |
56
- | ipcMain/ipcRenderer | Process communication |
57
- | nodeIntegration: false | Security |
58
- | contextIsolation: true | Security |
55
+ |contextBridge|Safe API exposure|
56
+ |ipcMain/ipcRenderer|Process communication|
57
+ |nodeIntegration: false|Security|
58
+ |contextIsolation: true|Security|
59
59
 
60
60
  ---
61
61
 
@@ -71,11 +71,11 @@ project-name/
71
71
 
72
72
  ## Build Targets
73
73
 
74
- | Platform | Output |
74
+ |Platform|Output|
75
75
  |----------|--------|
76
- | Windows | NSIS, Portable |
77
- | macOS | DMG, ZIP |
78
- | Linux | AppImage, DEB |
76
+ |Windows|NSIS, Portable|
77
+ |macOS|DMG, ZIP|
78
+ |Linux|AppImage, DEB|
79
79
 
80
80
  ---
81
81
 
@@ -7,14 +7,14 @@ description: Express.js REST API template principles. TypeScript, Prisma, JWT.
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
11
  |-----------|------------|
12
- | Runtime | Node.js 20+ |
13
- | Framework | Express.js |
14
- | Language | TypeScript |
15
- | Database | PostgreSQL + Prisma |
16
- | Validation | Zod |
17
- | Auth | JWT + bcrypt |
12
+ |Runtime|Node.js 20+|
13
+ |Framework|Express.js|
14
+ |Language|TypeScript|
15
+ |Database|PostgreSQL + Prisma|
16
+ |Validation|Zod|
17
+ |Auth|JWT + bcrypt|
18
18
 
19
19
  ---
20
20
 
@@ -43,23 +43,23 @@ project-name/
43
43
 
44
44
  ## Middleware Stack
45
45
 
46
- | Order | Middleware |
46
+ |Order|Middleware|
47
47
  |-------|------------|
48
- | 1 | helmet (security) |
49
- | 2 | cors |
50
- | 3 | morgan (logging) |
51
- | 4 | body parsing |
52
- | 5 | routes |
53
- | 6 | error handler |
48
+ |1|helmet (security)|
49
+ |2|cors|
50
+ |3|morgan (logging)|
51
+ |4|body parsing|
52
+ |5|routes|
53
+ |6|error handler|
54
54
 
55
55
  ---
56
56
 
57
57
  ## API Response Format
58
58
 
59
- | Type | Structure |
59
+ |Type|Structure|
60
60
  |------|-----------|
61
- | Success | `{ success: true, data: {...} }` |
62
- | Error | `{ error: "message", details: [...] }` |
61
+ |Success|`{ success: true, data: {...} }`|
62
+ |Error|`{ error: "message", details: [...] }`|
63
63
 
64
64
  ---
65
65
 
@@ -7,14 +7,14 @@ description: Flutter mobile app template principles. Riverpod, Go Router, clean
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
11
  |-----------|------------|
12
- | Framework | Flutter 3.x |
13
- | Language | Dart 3.x |
14
- | State | Riverpod 2.0 |
15
- | Navigation | Go Router |
16
- | HTTP | Dio |
17
- | Storage | Hive |
12
+ |Framework|Flutter 3.x|
13
+ |Language|Dart 3.x|
14
+ |State|Riverpod 2.0|
15
+ |Navigation|Go Router|
16
+ |HTTP|Dio|
17
+ |Storage|Hive|
18
18
 
19
19
  ---
20
20
 
@@ -50,24 +50,24 @@ project_name/
50
50
 
51
51
  ## Architecture Layers
52
52
 
53
- | Layer | Contents |
53
+ |Layer|Contents|
54
54
  |-------|----------|
55
- | Presentation | Screens, Widgets, Providers |
56
- | Domain | Entities, Use Cases |
57
- | Data | Repositories, Models |
55
+ |Presentation|Screens, Widgets, Providers|
56
+ |Domain|Entities, Use Cases|
57
+ |Data|Repositories, Models|
58
58
 
59
59
  ---
60
60
 
61
61
  ## Key Packages
62
62
 
63
- | Package | Purpose |
63
+ |Package|Purpose|
64
64
  |---------|---------|
65
- | flutter_riverpod | State management |
66
- | riverpod_annotation | Code generation |
67
- | go_router | Navigation |
68
- | dio | HTTP client |
69
- | freezed | Immutable models |
70
- | hive | Local storage |
65
+ |flutter_riverpod|State management|
66
+ |riverpod_annotation|Code generation|
67
+ |go_router|Navigation|
68
+ |dio|HTTP client|
69
+ |freezed|Immutable models|
70
+ |hive|Local storage|
71
71
 
72
72
  ---
73
73
 
@@ -7,13 +7,13 @@ description: Turborepo monorepo template principles. pnpm workspaces, shared pac
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
11
  |-----------|------------|
12
- | Build System | Turborepo |
13
- | Package Manager | pnpm |
14
- | Apps | Next.js, Express |
15
- | Packages | Shared UI, Config, Types |
16
- | Language | TypeScript |
12
+ |Build System|Turborepo|
13
+ |Package Manager|pnpm|
14
+ |Apps|Next.js, Express|
15
+ |Packages|Shared UI, Config, Types|
16
+ |Language|TypeScript|
17
17
 
18
18
  ---
19
19
 
@@ -39,23 +39,23 @@ project-name/
39
39
 
40
40
  ## Key Concepts
41
41
 
42
- | Concept | Description |
42
+ |Concept|Description|
43
43
  |---------|-------------|
44
- | Workspaces | pnpm-workspace.yaml |
45
- | Pipeline | turbo.json task graph |
46
- | Caching | Remote/local task caching |
47
- | Dependencies | `workspace:*` protocol |
44
+ |Workspaces|pnpm-workspace.yaml|
45
+ |Pipeline|turbo.json task graph|
46
+ |Caching|Remote/local task caching|
47
+ |Dependencies|`workspace:*` protocol|
48
48
 
49
49
  ---
50
50
 
51
51
  ## Turbo Pipeline
52
52
 
53
- | Task | Depends On |
53
+ |Task|Depends On|
54
54
  |------|------------|
55
- | build | ^build (dependencies first) |
56
- | dev | cache: false, persistent |
57
- | lint | ^build |
58
- | test | ^build |
55
+ |build|^build (dependencies first)|
56
+ |dev|cache: false, persistent|
57
+ |lint|^build|
58
+ |test|^build|
59
59
 
60
60
  ---
61
61
 
@@ -73,12 +73,12 @@ project-name/
73
73
 
74
74
  ## Common Commands
75
75
 
76
- | Command | Description |
76
+ |Command|Description|
77
77
  |---------|-------------|
78
- | `pnpm dev` | Run all apps |
79
- | `pnpm build` | Build all |
80
- | `pnpm --filter @name/web dev` | Run specific app |
81
- | `pnpm --filter @name/web add axios` | Add dep to app |
78
+ |`pnpm dev`|Run all apps|
79
+ |`pnpm build`|Build all|
80
+ |`pnpm --filter @name/web dev`|Run specific app|
81
+ |`pnpm --filter @name/web add axios`|Add dep to app|
82
82
 
83
83
  ---
84
84
 
@@ -7,15 +7,15 @@ description: Next.js full-stack template principles. App Router, Prisma, Tailwin
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology | Version / Notes |
10
+ |Component|Technology|Version / Notes|
11
11
  |-----------|------------|-----------------|
12
- | Framework | Next.js | v16+ (App Router, Turbopack) |
13
- | Language | TypeScript | v5+ (Strict Mode) |
14
- | Database | PostgreSQL | Prisma ORM (Serverless friendly) |
15
- | Styling | Tailwind CSS | v4.0 (Zero-config, CSS-first) |
16
- | Auth | Clerk / Better Auth | Middleware Protected Routes |
17
- | UI Logic | React 19 | Server Actions, useActionState |
18
- | Validation | Zod | Schema validation (API & Forms) |
12
+ |Framework|Next.js|v16+ (App Router, Turbopack)|
13
+ |Language|TypeScript|v5+ (Strict Mode)|
14
+ |Database|PostgreSQL|Prisma ORM (Serverless friendly)|
15
+ |Styling|Tailwind CSS|v4.0 (Zero-config, CSS-first)|
16
+ |Auth|Clerk / Better Auth|Middleware Protected Routes|
17
+ |UI Logic|React 19|Server Actions, useActionState|
18
+ |Validation|Zod|Schema validation (API & Forms)|
19
19
 
20
20
  ---
21
21
 
@@ -51,24 +51,24 @@ project-name/
51
51
 
52
52
  ## Key Concepts (Updated)
53
53
 
54
- | Concept | Description |
54
+ |Concept|Description|
55
55
  |---------|-------------|
56
- | Server Components | Render on server (default). Direct DB access (Prisma) without APIs. |
57
- | Server Actions | Handle Form mutations. Replaces traditional API Routes. Use in action={}. |
58
- | React 19 Hooks | Form state management: useActionState, useFormStatus, useOptimistic. |
59
- | Data Access Layer | Data security. Separation of DB logic (DTOs) for safe reuse. |
60
- | Tailwind v4 | Styling engine. No tailwind.config.js. Config directly in CSS. |
56
+ |Server Components|Render on server (default). Direct DB access (Prisma) without APIs.|
57
+ |Server Actions|Handle Form mutations. Replaces traditional API Routes. Use in action={}.|
58
+ |React 19 Hooks|Form state management: useActionState, useFormStatus, useOptimistic.|
59
+ |Data Access Layer|Data security. Separation of DB logic (DTOs) for safe reuse.|
60
+ |Tailwind v4|Styling engine. No tailwind.config.js. Config directly in CSS.|
61
61
 
62
62
  ---
63
63
 
64
64
  ## Environment Variables
65
65
 
66
- | Variable | Purpose |
66
+ |Variable|Purpose|
67
67
  |----------|---------|
68
- | DATABASE_URL | PostgreSQL connection string (Prisma) |
69
- | NEXT_PUBLIC_APP_URL | Public application URL |
70
- | NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY | Auth (if using Clerk) |
71
- | CLERK_SECRET_KEY | Auth Secret (Server only) |
68
+ |DATABASE_URL|PostgreSQL connection string (Prisma)|
69
+ |NEXT_PUBLIC_APP_URL|Public application URL|
70
+ |NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY|Auth (if using Clerk)|
71
+ |CLERK_SECRET_KEY|Auth Secret (Server only)|
72
72
 
73
73
  ---
74
74
 
@@ -7,15 +7,15 @@ description: Next.js SaaS template principles (2026 Standards). React 19, Server
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology | Version / Notes |
10
+ |Component|Technology|Version / Notes|
11
11
  |-----------|------------|-----------------|
12
- | Framework | Next.js | v16+ (App Router, React Compiler) |
13
- | Runtime | Node.js | v24 (Krypton LTS) |
14
- | Auth | Auth.js | v6 (formerly NextAuth) |
15
- | Payments | Stripe API | Latest |
16
- | Database | PostgreSQL | Prisma v6 (Serverless Driver) |
17
- | Email | Resend | React Email |
18
- | UI | Tailwind CSS | v4 (Oxide Engine, no config file) |
12
+ |Framework|Next.js|v16+ (App Router, React Compiler)|
13
+ |Runtime|Node.js|v24 (Krypton LTS)|
14
+ |Auth|Auth.js|v6 (formerly NextAuth)|
15
+ |Payments|Stripe API|Latest|
16
+ |Database|PostgreSQL|Prisma v6 (Serverless Driver)|
17
+ |Email|Resend|React Email|
18
+ |UI|Tailwind CSS|v4 (Oxide Engine, no config file)|
19
19
 
20
20
  ---
21
21
 
@@ -53,37 +53,37 @@ project-name/
53
53
 
54
54
  ## SaaS Features
55
55
 
56
- | Feature | Implementation |
56
+ |Feature|Implementation|
57
57
  |---------|---------------|
58
- | Auth | Auth.js v6 + Passkeys + OAuth |
59
- | Data Mutation | Server Actions (No API routes) |
60
- | Subscriptions | Stripe Checkout & Customer Portal |
61
- | Webhooks | Asynchronous Stripe event handling |
62
- | Email | Transactional via Resend |
63
- | Validation | Zod (Server-side validation) |
58
+ |Auth|Auth.js v6 + Passkeys + OAuth|
59
+ |Data Mutation|Server Actions (No API routes)|
60
+ |Subscriptions|Stripe Checkout & Customer Portal|
61
+ |Webhooks|Asynchronous Stripe event handling|
62
+ |Email|Transactional via Resend|
63
+ |Validation|Zod (Server-side validation)|
64
64
 
65
65
  ---
66
66
 
67
67
  ## Database Schema
68
68
 
69
- | Model | Fields (Key fields) |
69
+ |Model|Fields (Key fields)|
70
70
  |-------|---------------------|
71
- | User | id, email, stripeCustomerId, subscriptionId, plan |
72
- | Account | OAuth provider data (Google, GitHub...) |
73
- | Session | User sessions (Database strategy) |
71
+ |User|id, email, stripeCustomerId, subscriptionId, plan|
72
+ |Account|OAuth provider data (Google, GitHub...)|
73
+ |Session|User sessions (Database strategy)|
74
74
 
75
75
  ---
76
76
 
77
77
  ## Environment Variables
78
78
 
79
- | Variable | Purpose |
79
+ |Variable|Purpose|
80
80
  |----------|---------|
81
- | DATABASE_URL | Prisma connection string (Postgres) |
82
- | AUTH_SECRET | Replaces NEXTAUTH_SECRET (Auth.js v6) |
83
- | STRIPE_SECRET_KEY | Payments (Server-side) |
84
- | STRIPE_WEBHOOK_SECRET | Webhook verification |
85
- | RESEND_API_KEY | Email sending |
86
- | NEXT_PUBLIC_APP_URL | Application Canonical URL |
81
+ |DATABASE_URL|Prisma connection string (Postgres)|
82
+ |AUTH_SECRET|Replaces NEXTAUTH_SECRET (Auth.js v6)|
83
+ |STRIPE_SECRET_KEY|Payments (Server-side)|
84
+ |STRIPE_WEBHOOK_SECRET|Webhook verification|
85
+ |RESEND_API_KEY|Email sending|
86
+ |NEXT_PUBLIC_APP_URL|Application Canonical URL|
87
87
 
88
88
  ---
89
89
 
@@ -7,15 +7,15 @@ description: Modern template for Next.js 16, React 19 & Tailwind v4. Optimized f
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology | Notes |
10
+ |Component|Technology|Notes|
11
11
  |-----------|------------|-------|
12
- | Framework | Next.js 16+ | App Router, Turbopack, Static Exports |
13
- | Core | React 19 | Server Components, New Hooks, Compiler |
14
- | Language | TypeScript | Strict Mode |
15
- | Styling | Tailwind CSS v4 | CSS-first configuration (No js config), Oxide Engine |
16
- | Animations | Framer Motion | Layout animations & gestures |
17
- | Icons | Lucide React | Lightweight SVG icons |
18
- | SEO | Metadata API | Native Next.js API (Replaces next-seo) |
12
+ |Framework|Next.js 16+|App Router, Turbopack, Static Exports|
13
+ |Core|React 19|Server Components, New Hooks, Compiler|
14
+ |Language|TypeScript|Strict Mode|
15
+ |Styling|Tailwind CSS v4|CSS-first configuration (No js config), Oxide Engine|
16
+ |Animations|Framer Motion|Layout animations & gestures|
17
+ |Icons|Lucide React|Lightweight SVG icons|
18
+ |SEO|Metadata API|Native Next.js API (Replaces next-seo)|
19
19
 
20
20
  ---
21
21
 
@@ -95,26 +95,26 @@ export const metadata: Metadata = {
95
95
 
96
96
  ## Landing Page Sections
97
97
 
98
- | Section | Purpose | Suggested Component |
98
+ |Section|Purpose|Suggested Component|
99
99
  |---------|---------|---------------------|
100
- | Hero | First impression, H1 & Main CTA | `<HeroSection />` |
101
- | Features | Product benefits (Grid/Bento layout) | `<FeaturesGrid />` |
102
- | Social Proof | Partner logos, User numbers | `<LogoCloud />` |
103
- | Testimonials | Customer reviews | `<TestimonialCarousel />` |
104
- | Pricing | Service plans | `<PricingCards />` |
105
- | FAQ | Questions & Answers (Good for SEO) | `<Accordion />` |
106
- | CTA | Final conversion | `<CallToAction />` |
100
+ |Hero|First impression, H1 & Main CTA|`<HeroSection />`|
101
+ |Features|Product benefits (Grid/Bento layout)|`<FeaturesGrid />`|
102
+ |Social Proof|Partner logos, User numbers|`<LogoCloud />`|
103
+ |Testimonials|Customer reviews|`<TestimonialCarousel />`|
104
+ |Pricing|Service plans|`<PricingCards />`|
105
+ |FAQ|Questions & Answers (Good for SEO)|`<Accordion />`|
106
+ |CTA|Final conversion|`<CallToAction />`|
107
107
 
108
108
  ---
109
109
 
110
110
  ## Animation Patterns (Framer Motion)
111
111
 
112
- | Pattern | Usage | Implementation |
112
+ |Pattern|Usage|Implementation|
113
113
  |---------|-------|----------------|
114
- | Fade Up | Headlines, paragraphs | `initial={{ opacity: 0, y: 20 }} animate={{ opacity: 1, y: 0 }}` |
115
- | Stagger | Lists of Features/Cards | Use variants with `staggerChildren` |
116
- | Parallax | Background images or floating elements | `useScroll` & `useTransform` |
117
- | Micro-interactions | Hover buttons, click effects | `whileHover={{ scale: 1.05 }} whileTap={{ scale: 0.95 }}` |
114
+ |Fade Up|Headlines, paragraphs|`initial={{ opacity: 0, y: 20 }} animate={{ opacity: 1, y: 0 }}`|
115
+ |Stagger|Lists of Features/Cards|Use variants with `staggerChildren`|
116
+ |Parallax|Background images or floating elements|`useScroll` & `useTransform`|
117
+ |Micro-interactions|Hover buttons, click effects|`whileHover={{ scale: 1.05 }} whileTap={{ scale: 0.95 }}`|
118
118
 
119
119
  ---
120
120
 
@@ -152,12 +152,12 @@ export const metadata: Metadata = {
152
152
 
153
153
  ## Deployment
154
154
 
155
- | Platform | Method | Important Notes |
155
+ |Platform|Method|Important Notes|
156
156
  |----------|--------|-----------------|
157
- | Vercel | Git Push | Auto-detects Next.js. Best for performance. |
158
- | GitHub Pages | GitHub Actions | Need to set `basePath` in `next.config.ts` if not using a custom domain. |
159
- | AWS S3 / CloudFront | Upload out folder | Ensure Error Document is configured to `404.html`. |
160
- | Netlify | Git Push | Set build command to `npm run build`. |
157
+ |Vercel|Git Push|Auto-detects Next.js. Best for performance.|
158
+ |GitHub Pages|GitHub Actions|Need to set `basePath` in `next.config.ts` if not using a custom domain.|
159
+ |AWS S3 / CloudFront|Upload out folder|Ensure Error Document is configured to `404.html`.|
160
+ |Netlify|Git Push|Set build command to `npm run build`.|
161
161
 
162
162
  ---
163
163
 
@@ -9,16 +9,16 @@ Mẫu template Full-Stack hiện đại cho Nuxt 4, tối ưu hóa hiệu suất
9
9
 
10
10
  ## Tech Stack
11
11
 
12
- | Component | Technology | Version / Notes |
12
+ |Component|Technology|Version / Notes|
13
13
  |-----------|------------|-----------------|
14
- | Framework | Nuxt | v4.0+ (App Directory structure) |
15
- | UI Engine | Vue | v3.6+ (Vapor Mode enabled) |
16
- | Language | TypeScript | v5+ (Strict Mode) |
17
- | State | Pinia | v3+ (Store syntax) |
18
- | Database | PostgreSQL | Prisma ORM |
19
- | Styling | Tailwind CSS | v4.0 (Vite Plugin, Zero-config) |
20
- | UI Lib | Nuxt UI | v3 (Tailwind v4 native) |
21
- | Validation | Zod | Schema validation |
14
+ |Framework|Nuxt|v4.0+ (App Directory structure)|
15
+ |UI Engine|Vue|v3.6+ (Vapor Mode enabled)|
16
+ |Language|TypeScript|v5+ (Strict Mode)|
17
+ |State|Pinia|v3+ (Store syntax)|
18
+ |Database|PostgreSQL|Prisma ORM|
19
+ |Styling|Tailwind CSS|v4.0 (Vite Plugin, Zero-config)|
20
+ |UI Lib|Nuxt UI|v3 (Tailwind v4 native)|
21
+ |Validation|Zod|Schema validation|
22
22
 
23
23
  ---
24
24
 
@@ -53,23 +53,23 @@ project-name/
53
53
 
54
54
  ## Key Concepts (2026)
55
55
 
56
- | Concept | Description | Future Update |
56
+ |Concept|Description|Future Update|
57
57
  |---------|-------------|---------------|
58
- | **App Directory** | `app/` | Tách biệt mã nguồn ứng dụng và file cấu hình root. |
59
- | **Vapor Mode** | Opt-in performance | Render không cần Virtual DOM (như SolidJS). Bật trong `nuxt.config`. |
60
- | **Server Functions** | RPC-style calls | Gọi hàm server trực tiếp từ client (thay thế dần API routes thủ công). |
61
- | **Tailwind v4** | CSS-first | Cấu hình theme trực tiếp trong CSS, không cần `tailwind.config.js`. |
62
- | **Nuxt Islands** | Server Components | Render component cô lập trên server (`<NuxtIsland name="..." />`). |
58
+ |**App Directory**|`app/`|Tách biệt mã nguồn ứng dụng và file cấu hình root.|
59
+ |**Vapor Mode**|Opt-in performance|Render không cần Virtual DOM (như SolidJS). Bật trong `nuxt.config`.|
60
+ |**Server Functions**|RPC-style calls|Gọi hàm server trực tiếp từ client (thay thế dần API routes thủ công).|
61
+ |**Tailwind v4**|CSS-first|Cấu hình theme trực tiếp trong CSS, không cần `tailwind.config.js`.|
62
+ |**Nuxt Islands**|Server Components|Render component cô lập trên server (`<NuxtIsland name="..." />`).|
63
63
 
64
64
  ---
65
65
 
66
66
  ## Environment Variables
67
67
 
68
- | Variable | Purpose |
68
+ |Variable|Purpose|
69
69
  |----------|---------|
70
- | DATABASE_URL | Prisma connection string (PostgreSQL) |
71
- | NUXT_PUBLIC_APP_URL | Canonical URL |
72
- | NUXT_SESSION_PASSWORD | Session encryption key |
70
+ |DATABASE_URL|Prisma connection string (PostgreSQL)|
71
+ |NUXT_PUBLIC_APP_URL|Canonical URL|
72
+ |NUXT_SESSION_PASSWORD|Session encryption key|
73
73
 
74
74
  ---
75
75
 
@@ -7,14 +7,14 @@ description: FastAPI REST API template principles. SQLAlchemy, Pydantic, Alembic
7
7
 
8
8
  ## Tech Stack
9
9
 
10
- | Component | Technology |
10
+ |Component|Technology|
11
11
  |-----------|------------|
12
- | Framework | FastAPI |
13
- | Language | Python 3.11+ |
14
- | ORM | SQLAlchemy 2.0 |
15
- | Validation | Pydantic v2 |
16
- | Migrations | Alembic |
17
- | Auth | JWT + passlib |
12
+ |Framework|FastAPI|
13
+ |Language|Python 3.11+|
14
+ |ORM|SQLAlchemy 2.0|
15
+ |Validation|Pydantic v2|
16
+ |Migrations|Alembic|
17
+ |Auth|JWT + passlib|
18
18
 
19
19
  ---
20
20
 
@@ -42,24 +42,24 @@ project-name/
42
42
 
43
43
  ## Key Concepts
44
44
 
45
- | Concept | Description |
45
+ |Concept|Description|
46
46
  |---------|-------------|
47
- | Async | async/await throughout |
48
- | Dependency Injection | FastAPI Depends |
49
- | Pydantic v2 | Validation + serialization |
50
- | SQLAlchemy 2.0 | Async sessions |
47
+ |Async|async/await throughout|
48
+ |Dependency Injection|FastAPI Depends|
49
+ |Pydantic v2|Validation + serialization|
50
+ |SQLAlchemy 2.0|Async sessions|
51
51
 
52
52
  ---
53
53
 
54
54
  ## API Structure
55
55
 
56
- | Layer | Responsibility |
56
+ |Layer|Responsibility|
57
57
  |-------|---------------|
58
- | Routers | HTTP handling |
59
- | Dependencies | Auth, validation |
60
- | Services | Business logic |
61
- | Models | Database entities |
62
- | Schemas | Request/response |
58
+ |Routers|HTTP handling|
59
+ |Dependencies|Auth, validation|
60
+ |Services|Business logic|
61
+ |Models|Database entities|
62
+ |Schemas|Request/response|
63
63
 
64
64
  ---
65
65