tribunal-kit 4.5.0 → 4.6.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 (217) hide show
  1. package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
  2. package/.agent/ARCHITECTURE.md +279 -277
  3. package/.agent/GEMINI.md +127 -121
  4. package/.agent/agents/accessibility-reviewer.md +187 -187
  5. package/.agent/agents/ai-code-reviewer.md +199 -199
  6. package/.agent/agents/api-architect.md +71 -66
  7. package/.agent/agents/backend-specialist.md +219 -215
  8. package/.agent/agents/cloud-engineer.md +98 -0
  9. package/.agent/agents/code-archaeologist.md +168 -161
  10. package/.agent/agents/database-architect.md +184 -184
  11. package/.agent/agents/db-latency-auditor.md +213 -216
  12. package/.agent/agents/debugger.md +198 -191
  13. package/.agent/agents/dependency-reviewer.md +106 -103
  14. package/.agent/agents/devops-engineer.md +218 -218
  15. package/.agent/agents/documentation-writer.md +209 -201
  16. package/.agent/agents/explorer-agent.md +167 -160
  17. package/.agent/agents/frontend-reviewer.md +162 -160
  18. package/.agent/agents/frontend-specialist.md +257 -248
  19. package/.agent/agents/game-developer.md +48 -48
  20. package/.agent/agents/logic-reviewer.md +118 -116
  21. package/.agent/agents/mobile-developer.md +197 -200
  22. package/.agent/agents/mobile-reviewer.md +159 -162
  23. package/.agent/agents/orchestrator.md +187 -181
  24. package/.agent/agents/penetration-tester.md +160 -157
  25. package/.agent/agents/performance-optimizer.md +183 -183
  26. package/.agent/agents/performance-reviewer.md +178 -178
  27. package/.agent/agents/precedence-reviewer.md +251 -250
  28. package/.agent/agents/product-manager.md +149 -142
  29. package/.agent/agents/product-owner.md +81 -80
  30. package/.agent/agents/project-planner.md +152 -142
  31. package/.agent/agents/qa-automation-engineer.md +216 -225
  32. package/.agent/agents/resilience-reviewer.md +88 -88
  33. package/.agent/agents/schema-reviewer.md +67 -67
  34. package/.agent/agents/security-auditor.md +180 -174
  35. package/.agent/agents/seo-specialist.md +188 -193
  36. package/.agent/agents/sql-reviewer.md +159 -161
  37. package/.agent/agents/supervisor-agent.md +173 -184
  38. package/.agent/agents/swarm-worker-contracts.md +170 -166
  39. package/.agent/agents/swarm-worker-registry.md +92 -92
  40. package/.agent/agents/system-architect.md +85 -0
  41. package/.agent/agents/test-coverage-reviewer.md +158 -160
  42. package/.agent/agents/test-engineer.md +118 -118
  43. package/.agent/agents/throughput-optimizer.md +291 -299
  44. package/.agent/agents/type-safety-reviewer.md +182 -175
  45. package/.agent/agents/ui-ux-auditor.md +300 -292
  46. package/.agent/agents/vitals-reviewer.md +223 -223
  47. package/.agent/mcp_config.json +37 -40
  48. package/.agent/patterns/generator.md +11 -9
  49. package/.agent/patterns/inversion.md +14 -12
  50. package/.agent/patterns/pipeline.md +11 -9
  51. package/.agent/patterns/reviewer.md +15 -13
  52. package/.agent/patterns/tool-wrapper.md +11 -9
  53. package/.agent/routing_index.json +654 -0
  54. package/.agent/rules/GEMINI.md +358 -352
  55. package/.agent/scripts/compile_router.py +112 -0
  56. package/.agent/scripts/migrate_skills_frontmatter.py +64 -0
  57. package/.agent/scripts/strengthen_skills.js +1 -1
  58. package/.agent/skills/advanced-rag-pipelines/SKILL.md +56 -0
  59. package/.agent/skills/agent-organizer/SKILL.md +156 -150
  60. package/.agent/skills/agentic-patterns/SKILL.md +313 -315
  61. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +190 -184
  62. package/.agent/skills/api-patterns/SKILL.md +253 -247
  63. package/.agent/skills/api-security-auditor/SKILL.md +195 -193
  64. package/.agent/skills/app-builder/SKILL.md +573 -572
  65. package/.agent/skills/app-builder/templates/SKILL.md +108 -115
  66. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  67. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  68. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  69. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  70. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  71. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  72. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  73. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -122
  74. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -122
  75. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -169
  76. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -134
  77. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  78. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -119
  79. package/.agent/skills/appflow-wireframe/SKILL.md +146 -145
  80. package/.agent/skills/architecture/SKILL.md +226 -219
  81. package/.agent/skills/authentication-best-practices/SKILL.md +197 -189
  82. package/.agent/skills/backend-security-expert/SKILL.md +16 -2
  83. package/.agent/skills/bash-linux/SKILL.md +179 -179
  84. package/.agent/skills/behavioral-modes/SKILL.md +239 -223
  85. package/.agent/skills/brainstorming/SKILL.md +498 -486
  86. package/.agent/skills/browser-native-ai/SKILL.md +57 -4
  87. package/.agent/skills/building-native-ui/SKILL.md +202 -202
  88. package/.agent/skills/cicd-pro/SKILL.md +442 -0
  89. package/.agent/skills/clean-code/SKILL.md +400 -381
  90. package/.agent/skills/cloud-architect/SKILL.md +439 -0
  91. package/.agent/skills/code-review-checklist/SKILL.md +203 -194
  92. package/.agent/skills/config-validator/SKILL.md +165 -165
  93. package/.agent/skills/containerization-pro/SKILL.md +452 -0
  94. package/.agent/skills/csharp-developer/SKILL.md +518 -518
  95. package/.agent/skills/data-validation-schemas/SKILL.md +333 -328
  96. package/.agent/skills/database-design/SKILL.md +247 -240
  97. package/.agent/skills/deployment-procedures/SKILL.md +172 -169
  98. package/.agent/skills/devops-engineer/SKILL.md +345 -345
  99. package/.agent/skills/devops-incident-responder/SKILL.md +143 -137
  100. package/.agent/skills/doc.md +209 -177
  101. package/.agent/skills/documentation-templates/SKILL.md +291 -279
  102. package/.agent/skills/edge-computing/SKILL.md +183 -181
  103. package/.agent/skills/error-resilience/SKILL.md +411 -428
  104. package/.agent/skills/extract-design-system/SKILL.md +160 -158
  105. package/.agent/skills/framer-motion-expert/SKILL.md +253 -244
  106. package/.agent/skills/frontend-design/SKILL.md +208 -201
  107. package/.agent/skills/frontend-security-expert/SKILL.md +16 -3
  108. package/.agent/skills/game-design-expert/SKILL.md +132 -129
  109. package/.agent/skills/game-engineering-expert/SKILL.md +148 -146
  110. package/.agent/skills/generative-ui-expert/SKILL.md +57 -1
  111. package/.agent/skills/geo-fundamentals/SKILL.md +148 -147
  112. package/.agent/skills/git-pro/SKILL.md +435 -0
  113. package/.agent/skills/github-operations/SKILL.md +335 -329
  114. package/.agent/skills/gsap-core/SKILL.md +319 -308
  115. package/.agent/skills/gsap-frameworks/SKILL.md +213 -207
  116. package/.agent/skills/gsap-performance/SKILL.md +139 -133
  117. package/.agent/skills/gsap-plugins/SKILL.md +486 -480
  118. package/.agent/skills/gsap-react/SKILL.md +202 -189
  119. package/.agent/skills/gsap-scrolltrigger/SKILL.md +357 -350
  120. package/.agent/skills/gsap-timeline/SKILL.md +165 -161
  121. package/.agent/skills/gsap-utils/SKILL.md +344 -338
  122. package/.agent/skills/harness-protocol/SKILL.md +48 -0
  123. package/.agent/skills/i18n-localization/SKILL.md +174 -163
  124. package/.agent/skills/intelligent-routing/SKILL.md +202 -246
  125. package/.agent/skills/knowledge-graph/SKILL.md +60 -52
  126. package/.agent/skills/lint-and-validate/SKILL.md +261 -261
  127. package/.agent/skills/llm-engineering/SKILL.md +400 -394
  128. package/.agent/skills/local-first/SKILL.md +178 -178
  129. package/.agent/skills/mcp-builder/SKILL.md +143 -142
  130. package/.agent/skills/mobile-design/SKILL.md +272 -263
  131. package/.agent/skills/monorepo-management/SKILL.md +335 -334
  132. package/.agent/skills/motion-engineering/SKILL.md +266 -234
  133. package/.agent/skills/nextjs-react-expert/SKILL.md +236 -234
  134. package/.agent/skills/nodejs-best-practices/SKILL.md +547 -548
  135. package/.agent/skills/observability/SKILL.md +343 -343
  136. package/.agent/skills/parallel-agents/SKILL.md +143 -146
  137. package/.agent/skills/performance-profiling/SKILL.md +259 -267
  138. package/.agent/skills/plan-writing/SKILL.md +150 -142
  139. package/.agent/skills/platform-engineer/SKILL.md +148 -147
  140. package/.agent/skills/playwright-best-practices/SKILL.md +188 -187
  141. package/.agent/skills/powershell-windows/SKILL.md +162 -162
  142. package/.agent/skills/project-idioms/SKILL.md +137 -137
  143. package/.agent/skills/python-patterns/SKILL.md +260 -259
  144. package/.agent/skills/python-pro/SKILL.md +324 -323
  145. package/.agent/skills/react-specialist/SKILL.md +305 -277
  146. package/.agent/skills/readme-builder/SKILL.md +310 -300
  147. package/.agent/skills/realtime-patterns/SKILL.md +323 -319
  148. package/.agent/skills/red-team-tactics/SKILL.md +231 -218
  149. package/.agent/skills/rust-pro/SKILL.md +671 -673
  150. package/.agent/skills/seo-fundamentals/SKILL.md +179 -179
  151. package/.agent/skills/server-management/SKILL.md +218 -214
  152. package/.agent/skills/shadcn-ui-expert/SKILL.md +231 -231
  153. package/.agent/skills/skill-creator/SKILL.md +87 -86
  154. package/.agent/skills/sql-pro/SKILL.md +629 -629
  155. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +97 -97
  156. package/.agent/skills/swiftui-expert/SKILL.md +204 -201
  157. package/.agent/skills/system-design-pro/SKILL.md +345 -0
  158. package/.agent/skills/systematic-debugging/SKILL.md +153 -142
  159. package/.agent/skills/tailwind-patterns/SKILL.md +610 -566
  160. package/.agent/skills/tdd-workflow/SKILL.md +169 -161
  161. package/.agent/skills/test-result-analyzer/SKILL.md +313 -309
  162. package/.agent/skills/testing-patterns/SKILL.md +566 -579
  163. package/.agent/skills/trend-researcher/SKILL.md +243 -237
  164. package/.agent/skills/typescript-advanced/SKILL.md +336 -335
  165. package/.agent/skills/ui-ux-pro-max/SKILL.md +590 -562
  166. package/.agent/skills/ui-ux-researcher/SKILL.md +244 -244
  167. package/.agent/skills/vue-expert/SKILL.md +294 -275
  168. package/.agent/skills/vulnerability-scanner/SKILL.md +416 -404
  169. package/.agent/skills/web-accessibility-auditor/SKILL.md +219 -218
  170. package/.agent/skills/web-design-guidelines/SKILL.md +192 -186
  171. package/.agent/skills/webapp-testing/SKILL.md +167 -169
  172. package/.agent/skills/webgpu-performance/SKILL.md +56 -2
  173. package/.agent/skills/whimsy-injector/SKILL.md +346 -325
  174. package/.agent/skills/workflow-optimizer/SKILL.md +231 -229
  175. package/.agent/workflows/acf.md +141 -0
  176. package/.agent/workflows/api-tester.md +176 -151
  177. package/.agent/workflows/audit.md +150 -127
  178. package/.agent/workflows/brainstorm.md +134 -110
  179. package/.agent/workflows/changelog.md +140 -112
  180. package/.agent/workflows/create.md +168 -124
  181. package/.agent/workflows/debug.md +190 -165
  182. package/.agent/workflows/deploy.md +201 -180
  183. package/.agent/workflows/enhance.md +154 -128
  184. package/.agent/workflows/fix.md +136 -114
  185. package/.agent/workflows/generate.md +198 -183
  186. package/.agent/workflows/marathon.md +37 -11
  187. package/.agent/workflows/migrate.md +184 -160
  188. package/.agent/workflows/orchestrate.md +192 -168
  189. package/.agent/workflows/performance-benchmarker.md +135 -114
  190. package/.agent/workflows/plan.md +196 -173
  191. package/.agent/workflows/preview.md +103 -80
  192. package/.agent/workflows/refactor.md +192 -161
  193. package/.agent/workflows/review-ai.md +125 -101
  194. package/.agent/workflows/review.md +141 -116
  195. package/.agent/workflows/session.md +122 -94
  196. package/.agent/workflows/status.md +101 -79
  197. package/.agent/workflows/strengthen-skills.md +164 -138
  198. package/.agent/workflows/super-prompt.md +24 -0
  199. package/.agent/workflows/swarm.md +193 -179
  200. package/.agent/workflows/test.md +211 -189
  201. package/.agent/workflows/tribunal-backend.md +136 -105
  202. package/.agent/workflows/tribunal-database.md +122 -95
  203. package/.agent/workflows/tribunal-frontend.md +221 -96
  204. package/.agent/workflows/tribunal-full.md +129 -100
  205. package/.agent/workflows/tribunal-mobile.md +122 -95
  206. package/.agent/workflows/tribunal-performance.md +136 -110
  207. package/.agent/workflows/tribunal-speed.md +209 -183
  208. package/.agent/workflows/ui-ux-pro-max.md +145 -122
  209. package/README.md +107 -55
  210. package/bin/mcp-server.js +159 -0
  211. package/bin/tribunal-kit.js +105 -29
  212. package/bin/wrapper.js +16 -7
  213. package/mcp_config.json +9 -0
  214. package/package.json +94 -86
  215. package/scripts/changelog.js +4 -3
  216. package/scripts/validate-payload.js +6 -1
  217. package/scripts/postinstall.js +0 -127
@@ -1,90 +1,90 @@
1
- ---
2
- name: flutter-app
3
- description: Flutter mobile app template principles. Riverpod, Go Router, clean architecture.
4
- ---
5
-
6
- # Flutter App Template
7
-
8
- ## Tech Stack
9
-
10
- |Component|Technology|
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|
18
-
19
- ---
20
-
21
- ## Directory Structure
22
-
23
- ```
24
- project_name/
25
- ├── lib/
26
- │ ├── main.dart
27
- │ ├── app.dart
28
- │ ├── core/
29
- │ │ ├── constants/
30
- │ │ ├── theme/
31
- │ │ ├── router/
32
- │ │ └── utils/
33
- │ ├── features/
34
- │ │ ├── auth/
35
- │ │ │ ├── data/
36
- │ │ │ ├── domain/
37
- │ │ │ └── presentation/
38
- │ │ └── home/
39
- │ ├── shared/
40
- │ │ ├── widgets/
41
- │ │ └── providers/
42
- │ └── services/
43
- │ ├── api/
44
- │ └── storage/
45
- ├── test/
46
- └── pubspec.yaml
47
- ```
48
-
49
- ---
50
-
51
- ## Architecture Layers
52
-
53
- |Layer|Contents|
54
- |-------|----------|
55
- |Presentation|Screens, Widgets, Providers|
56
- |Domain|Entities, Use Cases|
57
- |Data|Repositories, Models|
58
-
59
- ---
60
-
61
- ## Key Packages
62
-
63
- |Package|Purpose|
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|
71
-
72
- ---
73
-
74
- ## Setup Steps
75
-
76
- 1. `flutter create {{name}} --org com.{{bundle}}`
77
- 2. Update `pubspec.yaml`
78
- 3. `flutter pub get`
79
- 4. Run code generation: `dart run build_runner build`
80
- 5. `flutter run`
81
-
82
- ---
83
-
84
- ## Best Practices
85
-
86
- - Feature-first folder structure
87
- - Riverpod for state, React Query pattern for server state
88
- - Freezed for immutable data classes
89
- - Go Router for declarative navigation
90
- - Material 3 theming
1
+ ---
2
+ name: flutter-app
3
+ description: Flutter mobile app template principles. Riverpod, Go Router, clean architecture.
4
+ ---
5
+
6
+ # Flutter App Template
7
+
8
+ ## Tech Stack
9
+
10
+ | Component | Technology |
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 |
18
+
19
+ ---
20
+
21
+ ## Directory Structure
22
+
23
+ ```
24
+ project_name/
25
+ ├── lib/
26
+ │ ├── main.dart
27
+ │ ├── app.dart
28
+ │ ├── core/
29
+ │ │ ├── constants/
30
+ │ │ ├── theme/
31
+ │ │ ├── router/
32
+ │ │ └── utils/
33
+ │ ├── features/
34
+ │ │ ├── auth/
35
+ │ │ │ ├── data/
36
+ │ │ │ ├── domain/
37
+ │ │ │ └── presentation/
38
+ │ │ └── home/
39
+ │ ├── shared/
40
+ │ │ ├── widgets/
41
+ │ │ └── providers/
42
+ │ └── services/
43
+ │ ├── api/
44
+ │ └── storage/
45
+ ├── test/
46
+ └── pubspec.yaml
47
+ ```
48
+
49
+ ---
50
+
51
+ ## Architecture Layers
52
+
53
+ | Layer | Contents |
54
+ | ------------ | --------------------------- |
55
+ | Presentation | Screens, Widgets, Providers |
56
+ | Domain | Entities, Use Cases |
57
+ | Data | Repositories, Models |
58
+
59
+ ---
60
+
61
+ ## Key Packages
62
+
63
+ | Package | Purpose |
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 |
71
+
72
+ ---
73
+
74
+ ## Setup Steps
75
+
76
+ 1. `flutter create {{name}} --org com.{{bundle}}`
77
+ 2. Update `pubspec.yaml`
78
+ 3. `flutter pub get`
79
+ 4. Run code generation: `dart run build_runner build`
80
+ 5. `flutter run`
81
+
82
+ ---
83
+
84
+ ## Best Practices
85
+
86
+ - Feature-first folder structure
87
+ - Riverpod for state, React Query pattern for server state
88
+ - Freezed for immutable data classes
89
+ - Go Router for declarative navigation
90
+ - Material 3 theming
@@ -1,90 +1,90 @@
1
- ---
2
- name: monorepo-turborepo
3
- description: Turborepo monorepo template principles. pnpm workspaces, shared packages.
4
- ---
5
-
6
- # Turborepo Monorepo Template
7
-
8
- ## Tech Stack
9
-
10
- |Component|Technology|
11
- |-----------|------------|
12
- |Build System|Turborepo|
13
- |Package Manager|pnpm|
14
- |Apps|Next.js, Express|
15
- |Packages|Shared UI, Config, Types|
16
- |Language|TypeScript|
17
-
18
- ---
19
-
20
- ## Directory Structure
21
-
22
- ```
23
- project-name/
24
- ├── apps/
25
- │ ├── web/ # Next.js app
26
- │ ├── api/ # Express API
27
- │ └── docs/ # Documentation
28
- ├── packages/
29
- │ ├── ui/ # Shared components
30
- │ ├── config/ # ESLint, TS, Tailwind
31
- │ ├── types/ # Shared types
32
- │ └── utils/ # Shared utilities
33
- ├── turbo.json
34
- ├── pnpm-workspace.yaml
35
- └── package.json
36
- ```
37
-
38
- ---
39
-
40
- ## Key Concepts
41
-
42
- |Concept|Description|
43
- |---------|-------------|
44
- |Workspaces|pnpm-workspace.yaml|
45
- |Pipeline|turbo.json task graph|
46
- |Caching|Remote/local task caching|
47
- |Dependencies|`workspace:*` protocol|
48
-
49
- ---
50
-
51
- ## Turbo Pipeline
52
-
53
- |Task|Depends On|
54
- |------|------------|
55
- |build|^build (dependencies first)|
56
- |dev|cache: false, persistent|
57
- |lint|^build|
58
- |test|^build|
59
-
60
- ---
61
-
62
- ## Setup Steps
63
-
64
- 1. Create root directory
65
- 2. `pnpm init`
66
- 3. Create pnpm-workspace.yaml
67
- 4. Create turbo.json
68
- 5. Add apps and packages
69
- 6. `pnpm install`
70
- 7. `pnpm dev`
71
-
72
- ---
73
-
74
- ## Common Commands
75
-
76
- |Command|Description|
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|
82
-
83
- ---
84
-
85
- ## Best Practices
86
-
87
- - Shared configs in packages/config
88
- - Shared types in packages/types
89
- - Internal packages with `workspace:*`
90
- - Use Turbo remote caching for CI
1
+ ---
2
+ name: monorepo-turborepo
3
+ description: Turborepo monorepo template principles. pnpm workspaces, shared packages.
4
+ ---
5
+
6
+ # Turborepo Monorepo Template
7
+
8
+ ## Tech Stack
9
+
10
+ | Component | Technology |
11
+ | --------------- | ------------------------ |
12
+ | Build System | Turborepo |
13
+ | Package Manager | pnpm |
14
+ | Apps | Next.js, Express |
15
+ | Packages | Shared UI, Config, Types |
16
+ | Language | TypeScript |
17
+
18
+ ---
19
+
20
+ ## Directory Structure
21
+
22
+ ```
23
+ project-name/
24
+ ├── apps/
25
+ │ ├── web/ # Next.js app
26
+ │ ├── api/ # Express API
27
+ │ └── docs/ # Documentation
28
+ ├── packages/
29
+ │ ├── ui/ # Shared components
30
+ │ ├── config/ # ESLint, TS, Tailwind
31
+ │ ├── types/ # Shared types
32
+ │ └── utils/ # Shared utilities
33
+ ├── turbo.json
34
+ ├── pnpm-workspace.yaml
35
+ └── package.json
36
+ ```
37
+
38
+ ---
39
+
40
+ ## Key Concepts
41
+
42
+ | Concept | Description |
43
+ | ------------ | ------------------------- |
44
+ | Workspaces | pnpm-workspace.yaml |
45
+ | Pipeline | turbo.json task graph |
46
+ | Caching | Remote/local task caching |
47
+ | Dependencies | `workspace:*` protocol |
48
+
49
+ ---
50
+
51
+ ## Turbo Pipeline
52
+
53
+ | Task | Depends On |
54
+ | ----- | --------------------------- |
55
+ | build | ^build (dependencies first) |
56
+ | dev | cache: false, persistent |
57
+ | lint | ^build |
58
+ | test | ^build |
59
+
60
+ ---
61
+
62
+ ## Setup Steps
63
+
64
+ 1. Create root directory
65
+ 2. `pnpm init`
66
+ 3. Create pnpm-workspace.yaml
67
+ 4. Create turbo.json
68
+ 5. Add apps and packages
69
+ 6. `pnpm install`
70
+ 7. `pnpm dev`
71
+
72
+ ---
73
+
74
+ ## Common Commands
75
+
76
+ | Command | Description |
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 |
82
+
83
+ ---
84
+
85
+ ## Best Practices
86
+
87
+ - Shared configs in packages/config
88
+ - Shared types in packages/types
89
+ - Internal packages with `workspace:*`
90
+ - Use Turbo remote caching for CI
@@ -1,122 +1,126 @@
1
- ---
2
- name: nextjs-fullstack
3
- description: Next.js full-stack template principles. App Router, Prisma, Tailwind v4.
4
- ---
5
-
6
- # Next.js Full-Stack Template (2026 Edition)
7
-
8
- ## Tech Stack
9
-
10
- |Component|Technology|Version / Notes|
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)|
19
-
20
- ---
21
-
22
- ## Directory Structure
23
-
24
- ```
25
- project-name/
26
- ├── prisma/
27
- │ └── schema.prisma # Database schema
28
- ├── src/
29
- │ ├── app/
30
- │ │ ├── (auth)/ # Route groups for Login/Register
31
- │ │ ├── (dashboard)/ # Protected routes
32
- │ │ ├── api/ # Route Handlers (only for Webhooks/External integration)
33
- │ │ ├── layout.tsx # Root Layout (Metadata, Providers)
34
- │ │ ├── page.tsx # Landing Page
35
- │ │ └── globals.css # Tailwind v4 config (@theme) lives here
36
- │ ├── components/
37
- │ │ ├── ui/ # Reusable UI (Button, Input)
38
- │ │ └── forms/ # Client forms using useActionState
39
- │ ├── lib/
40
- │ │ ├── db.ts # Prisma singleton client
41
- │ │ ├── utils.ts # Helper functions
42
- │ │ └── dal.ts # Data Access Layer (Server-only)
43
- │ ├── actions/ # Server Actions (Mutations)
44
- │ └── types/ # Global TS Types
45
- ├── public/
46
- ├── next.config.ts # TypeScript Config
47
- └── package.json
48
- ```
49
-
50
- ---
51
-
52
- ## Key Concepts (Updated)
53
-
54
- |Concept|Description|
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.|
61
-
62
- ---
63
-
64
- ## Environment Variables
65
-
66
- |Variable|Purpose|
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)|
72
-
73
- ---
74
-
75
- ## Setup Steps
76
-
77
- 1. Initialize Project:
78
- ```bash
79
- npx create-next-app@latest my-app --typescript --tailwind --eslint
80
- # Select Yes for App Router
81
- # Select No for src directory (optional, this template uses src)
82
- ```
83
-
84
- 2. Install DB & Validation:
85
- ```bash
86
- npm install prisma @prisma/client zod
87
- npm install -D ts-node # For running seed scripts
88
- ```
89
-
90
- 3. Configure Tailwind v4 (If missing):
91
- Ensure `src/app/globals.css` uses the new import syntax instead of a config file:
92
- ```css
93
- @import "tailwindcss";
94
-
95
- @theme {
96
- --color-primary: oklch(0.5 0.2 240);
97
- --font-sans: "Inter", sans-serif;
98
- }
99
- ```
100
-
101
- 4. Initialize Database:
102
- ```bash
103
- npx prisma init
104
- # Update schema.prisma
105
- npm run db:push
106
- ```
107
-
108
- 5. Run Developer Server:
109
- ```bash
110
- npm run dev --turbo
111
- # --turbo to enable faster Turbopack
112
- ```
113
-
114
- ---
115
-
116
- ## Best Practices (2026 Standards)
117
-
118
- - **Fetch Data**: Call Prisma directly in Server Components (async/await). Do not use useEffect for initial data fetching.
119
- - **Mutations**: Use Server Actions combined with React 19's `useActionState` to handle loading and error states instead of manual useState.
120
- - **Type Safety**: Share Zod schemas between Server Actions (input validation) and Client Forms.
121
- - **Security**: Always validate input data with Zod before passing it to Prisma.
122
- - **Styling**: Use native CSS variables in Tailwind v4 for easier dynamic theming.
1
+ ---
2
+ name: nextjs-fullstack
3
+ description: Next.js full-stack template principles. App Router, Prisma, Tailwind v4.
4
+ ---
5
+
6
+ # Next.js Full-Stack Template (2026 Edition)
7
+
8
+ ## Tech Stack
9
+
10
+ | Component | Technology | Version / Notes |
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) |
19
+
20
+ ---
21
+
22
+ ## Directory Structure
23
+
24
+ ```
25
+ project-name/
26
+ ├── prisma/
27
+ │ └── schema.prisma # Database schema
28
+ ├── src/
29
+ │ ├── app/
30
+ │ │ ├── (auth)/ # Route groups for Login/Register
31
+ │ │ ├── (dashboard)/ # Protected routes
32
+ │ │ ├── api/ # Route Handlers (only for Webhooks/External integration)
33
+ │ │ ├── layout.tsx # Root Layout (Metadata, Providers)
34
+ │ │ ├── page.tsx # Landing Page
35
+ │ │ └── globals.css # Tailwind v4 config (@theme) lives here
36
+ │ ├── components/
37
+ │ │ ├── ui/ # Reusable UI (Button, Input)
38
+ │ │ └── forms/ # Client forms using useActionState
39
+ │ ├── lib/
40
+ │ │ ├── db.ts # Prisma singleton client
41
+ │ │ ├── utils.ts # Helper functions
42
+ │ │ └── dal.ts # Data Access Layer (Server-only)
43
+ │ ├── actions/ # Server Actions (Mutations)
44
+ │ └── types/ # Global TS Types
45
+ ├── public/
46
+ ├── next.config.ts # TypeScript Config
47
+ └── package.json
48
+ ```
49
+
50
+ ---
51
+
52
+ ## Key Concepts (Updated)
53
+
54
+ | Concept | Description |
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. |
61
+
62
+ ---
63
+
64
+ ## Environment Variables
65
+
66
+ | Variable | Purpose |
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) |
72
+
73
+ ---
74
+
75
+ ## Setup Steps
76
+
77
+ 1. Initialize Project:
78
+
79
+ ```bash
80
+ npx create-next-app@latest my-app --typescript --tailwind --eslint
81
+ # Select Yes for App Router
82
+ # Select No for src directory (optional, this template uses src)
83
+ ```
84
+
85
+ 2. Install DB & Validation:
86
+
87
+ ```bash
88
+ npm install prisma @prisma/client zod
89
+ npm install -D ts-node # For running seed scripts
90
+ ```
91
+
92
+ 3. Configure Tailwind v4 (If missing):
93
+ Ensure `src/app/globals.css` uses the new import syntax instead of a config file:
94
+
95
+ ```css
96
+ @import "tailwindcss";
97
+
98
+ @theme {
99
+ --color-primary: oklch(0.5 0.2 240);
100
+ --font-sans: "Inter", sans-serif;
101
+ }
102
+ ```
103
+
104
+ 4. Initialize Database:
105
+
106
+ ```bash
107
+ npx prisma init
108
+ # Update schema.prisma
109
+ npm run db:push
110
+ ```
111
+
112
+ 5. Run Developer Server:
113
+ ```bash
114
+ npm run dev --turbo
115
+ # --turbo to enable faster Turbopack
116
+ ```
117
+
118
+ ---
119
+
120
+ ## Best Practices (2026 Standards)
121
+
122
+ - **Fetch Data**: Call Prisma directly in Server Components (async/await). Do not use useEffect for initial data fetching.
123
+ - **Mutations**: Use Server Actions combined with React 19's `useActionState` to handle loading and error states instead of manual useState.
124
+ - **Type Safety**: Share Zod schemas between Server Actions (input validation) and Client Forms.
125
+ - **Security**: Always validate input data with Zod before passing it to Prisma.
126
+ - **Styling**: Use native CSS variables in Tailwind v4 for easier dynamic theming.