tribunal-kit 4.5.1 → 4.6.1

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 (214) hide show
  1. package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
  2. package/.agent/ARCHITECTURE.md +282 -277
  3. package/.agent/agents/accessibility-reviewer.md +187 -187
  4. package/.agent/agents/ai-code-reviewer.md +199 -199
  5. package/.agent/agents/api-architect.md +71 -66
  6. package/.agent/agents/backend-specialist.md +219 -215
  7. package/.agent/agents/cloud-engineer.md +98 -0
  8. package/.agent/agents/code-archaeologist.md +168 -161
  9. package/.agent/agents/database-architect.md +184 -184
  10. package/.agent/agents/db-latency-auditor.md +213 -216
  11. package/.agent/agents/debugger.md +198 -191
  12. package/.agent/agents/dependency-reviewer.md +106 -103
  13. package/.agent/agents/devops-engineer.md +218 -218
  14. package/.agent/agents/documentation-writer.md +209 -201
  15. package/.agent/agents/explorer-agent.md +167 -160
  16. package/.agent/agents/frontend-reviewer.md +162 -160
  17. package/.agent/agents/frontend-specialist.md +257 -248
  18. package/.agent/agents/game-developer.md +48 -48
  19. package/.agent/agents/logic-reviewer.md +118 -116
  20. package/.agent/agents/mobile-developer.md +197 -200
  21. package/.agent/agents/mobile-reviewer.md +159 -162
  22. package/.agent/agents/orchestrator.md +187 -181
  23. package/.agent/agents/penetration-tester.md +160 -157
  24. package/.agent/agents/performance-optimizer.md +183 -183
  25. package/.agent/agents/performance-reviewer.md +178 -178
  26. package/.agent/agents/precedence-reviewer.md +251 -250
  27. package/.agent/agents/product-manager.md +149 -142
  28. package/.agent/agents/product-owner.md +81 -80
  29. package/.agent/agents/project-planner.md +152 -142
  30. package/.agent/agents/qa-automation-engineer.md +216 -225
  31. package/.agent/agents/resilience-reviewer.md +88 -88
  32. package/.agent/agents/schema-reviewer.md +67 -67
  33. package/.agent/agents/security-auditor.md +180 -174
  34. package/.agent/agents/seo-specialist.md +188 -193
  35. package/.agent/agents/sql-reviewer.md +159 -161
  36. package/.agent/agents/supervisor-agent.md +173 -184
  37. package/.agent/agents/swarm-worker-contracts.md +170 -166
  38. package/.agent/agents/swarm-worker-registry.md +92 -92
  39. package/.agent/agents/system-architect.md +85 -0
  40. package/.agent/agents/test-coverage-reviewer.md +158 -160
  41. package/.agent/agents/test-engineer.md +118 -118
  42. package/.agent/agents/throughput-optimizer.md +291 -299
  43. package/.agent/agents/type-safety-reviewer.md +182 -175
  44. package/.agent/agents/ui-ux-auditor.md +300 -292
  45. package/.agent/agents/vitals-reviewer.md +223 -223
  46. package/.agent/mcp_config.json +37 -40
  47. package/.agent/patterns/generator.md +11 -9
  48. package/.agent/patterns/inversion.md +14 -12
  49. package/.agent/patterns/pipeline.md +11 -9
  50. package/.agent/patterns/reviewer.md +15 -13
  51. package/.agent/patterns/tool-wrapper.md +11 -9
  52. package/.agent/routing_index.json +714 -0
  53. package/.agent/rules/GEMINI.md +359 -352
  54. package/.agent/scripts/compile_router.py +112 -0
  55. package/.agent/scripts/migrate_skills_frontmatter.py +64 -0
  56. package/.agent/scripts/strengthen_skills.js +1 -1
  57. package/.agent/skills/advanced-rag-pipelines/SKILL.md +56 -0
  58. package/.agent/skills/agent-organizer/SKILL.md +156 -150
  59. package/.agent/skills/agentic-patterns/SKILL.md +313 -315
  60. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +190 -184
  61. package/.agent/skills/api-patterns/SKILL.md +253 -247
  62. package/.agent/skills/api-security-auditor/SKILL.md +195 -193
  63. package/.agent/skills/app-builder/SKILL.md +573 -572
  64. package/.agent/skills/app-builder/templates/SKILL.md +108 -115
  65. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  66. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  67. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  68. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  69. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  70. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  71. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  72. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -122
  73. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -122
  74. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -169
  75. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -134
  76. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  77. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -119
  78. package/.agent/skills/appflow-wireframe/SKILL.md +146 -145
  79. package/.agent/skills/architecture/SKILL.md +226 -219
  80. package/.agent/skills/authentication-best-practices/SKILL.md +197 -189
  81. package/.agent/skills/backend-security-expert/SKILL.md +16 -2
  82. package/.agent/skills/bash-linux/SKILL.md +179 -179
  83. package/.agent/skills/behavioral-modes/SKILL.md +239 -223
  84. package/.agent/skills/brainstorming/SKILL.md +498 -486
  85. package/.agent/skills/browser-native-ai/SKILL.md +57 -4
  86. package/.agent/skills/building-native-ui/SKILL.md +202 -202
  87. package/.agent/skills/cicd-pro/SKILL.md +442 -0
  88. package/.agent/skills/clean-code/SKILL.md +400 -381
  89. package/.agent/skills/cloud-architect/SKILL.md +439 -0
  90. package/.agent/skills/code-review-checklist/SKILL.md +203 -194
  91. package/.agent/skills/config-validator/SKILL.md +165 -165
  92. package/.agent/skills/containerization-pro/SKILL.md +452 -0
  93. package/.agent/skills/csharp-developer/SKILL.md +518 -518
  94. package/.agent/skills/data-validation-schemas/SKILL.md +333 -328
  95. package/.agent/skills/database-design/SKILL.md +247 -240
  96. package/.agent/skills/deployment-procedures/SKILL.md +172 -169
  97. package/.agent/skills/devops-engineer/SKILL.md +345 -345
  98. package/.agent/skills/devops-incident-responder/SKILL.md +143 -137
  99. package/.agent/skills/documentation-templates/SKILL.md +291 -279
  100. package/.agent/skills/edge-computing/SKILL.md +183 -181
  101. package/.agent/skills/emil-design-eng/SKILL.md +147 -0
  102. package/.agent/skills/error-resilience/SKILL.md +411 -428
  103. package/.agent/skills/extract-design-system/SKILL.md +160 -158
  104. package/.agent/skills/framer-motion-expert/SKILL.md +253 -244
  105. package/.agent/skills/frontend-design/SKILL.md +208 -201
  106. package/.agent/skills/frontend-security-expert/SKILL.md +16 -3
  107. package/.agent/skills/game-design-expert/SKILL.md +132 -129
  108. package/.agent/skills/game-engineering-expert/SKILL.md +148 -146
  109. package/.agent/skills/generative-ui-expert/SKILL.md +57 -1
  110. package/.agent/skills/geo-fundamentals/SKILL.md +148 -147
  111. package/.agent/skills/git-pro/SKILL.md +435 -0
  112. package/.agent/skills/github-operations/SKILL.md +335 -329
  113. package/.agent/skills/gsap-core/SKILL.md +319 -308
  114. package/.agent/skills/gsap-frameworks/SKILL.md +213 -207
  115. package/.agent/skills/gsap-performance/SKILL.md +139 -133
  116. package/.agent/skills/gsap-plugins/SKILL.md +486 -480
  117. package/.agent/skills/gsap-react/SKILL.md +202 -189
  118. package/.agent/skills/gsap-scrolltrigger/SKILL.md +357 -350
  119. package/.agent/skills/gsap-timeline/SKILL.md +165 -161
  120. package/.agent/skills/gsap-utils/SKILL.md +344 -338
  121. package/.agent/skills/harness-protocol/SKILL.md +48 -0
  122. package/.agent/skills/i18n-localization/SKILL.md +174 -163
  123. package/.agent/skills/intelligent-routing/SKILL.md +202 -246
  124. package/.agent/skills/knowledge-graph/SKILL.md +60 -52
  125. package/.agent/skills/lint-and-validate/SKILL.md +261 -261
  126. package/.agent/skills/llm-engineering/SKILL.md +400 -394
  127. package/.agent/skills/local-first/SKILL.md +178 -178
  128. package/.agent/skills/mcp-builder/SKILL.md +143 -142
  129. package/.agent/skills/mobile-design/SKILL.md +272 -263
  130. package/.agent/skills/monorepo-management/SKILL.md +335 -334
  131. package/.agent/skills/motion-engineering/SKILL.md +266 -234
  132. package/.agent/skills/nextjs-react-expert/SKILL.md +236 -234
  133. package/.agent/skills/nodejs-best-practices/SKILL.md +547 -548
  134. package/.agent/skills/observability/SKILL.md +343 -343
  135. package/.agent/skills/parallel-agents/SKILL.md +143 -146
  136. package/.agent/skills/performance-profiling/SKILL.md +259 -267
  137. package/.agent/skills/plan-writing/SKILL.md +150 -142
  138. package/.agent/skills/platform-engineer/SKILL.md +148 -147
  139. package/.agent/skills/playwright-best-practices/SKILL.md +188 -187
  140. package/.agent/skills/powershell-windows/SKILL.md +162 -162
  141. package/.agent/skills/project-idioms/SKILL.md +137 -137
  142. package/.agent/skills/python-patterns/SKILL.md +260 -259
  143. package/.agent/skills/python-pro/SKILL.md +324 -323
  144. package/.agent/skills/react-specialist/SKILL.md +305 -277
  145. package/.agent/skills/readme-builder/SKILL.md +310 -300
  146. package/.agent/skills/realtime-patterns/SKILL.md +323 -319
  147. package/.agent/skills/red-team-tactics/SKILL.md +231 -218
  148. package/.agent/skills/review-animations/SKILL.md +72 -0
  149. package/.agent/skills/review-animations/STANDARDS.md +73 -0
  150. package/.agent/skills/rust-pro/SKILL.md +671 -673
  151. package/.agent/skills/seo-fundamentals/SKILL.md +179 -179
  152. package/.agent/skills/server-management/SKILL.md +218 -214
  153. package/.agent/skills/shadcn-ui-expert/SKILL.md +231 -231
  154. package/.agent/skills/skill-creator/SKILL.md +87 -86
  155. package/.agent/skills/sql-pro/SKILL.md +629 -629
  156. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +97 -97
  157. package/.agent/skills/swiftui-expert/SKILL.md +204 -201
  158. package/.agent/skills/system-design-pro/SKILL.md +345 -0
  159. package/.agent/skills/systematic-debugging/SKILL.md +153 -142
  160. package/.agent/skills/tailwind-patterns/SKILL.md +610 -566
  161. package/.agent/skills/tdd-workflow/SKILL.md +169 -161
  162. package/.agent/skills/test-result-analyzer/SKILL.md +313 -309
  163. package/.agent/skills/testing-patterns/SKILL.md +566 -579
  164. package/.agent/skills/trend-researcher/SKILL.md +243 -237
  165. package/.agent/skills/typescript-advanced/SKILL.md +336 -335
  166. package/.agent/skills/ui-ux-pro-max/SKILL.md +590 -562
  167. package/.agent/skills/ui-ux-researcher/SKILL.md +244 -244
  168. package/.agent/skills/vue-expert/SKILL.md +294 -275
  169. package/.agent/skills/vulnerability-scanner/SKILL.md +416 -404
  170. package/.agent/skills/web-accessibility-auditor/SKILL.md +219 -218
  171. package/.agent/skills/web-design-guidelines/SKILL.md +192 -186
  172. package/.agent/skills/webapp-testing/SKILL.md +167 -169
  173. package/.agent/skills/webgpu-performance/SKILL.md +56 -2
  174. package/.agent/skills/whimsy-injector/SKILL.md +346 -325
  175. package/.agent/skills/workflow-optimizer/SKILL.md +231 -229
  176. package/.agent/workflows/acf.md +141 -0
  177. package/.agent/workflows/api-tester.md +176 -151
  178. package/.agent/workflows/audit.md +150 -127
  179. package/.agent/workflows/brainstorm.md +134 -110
  180. package/.agent/workflows/changelog.md +140 -112
  181. package/.agent/workflows/create.md +168 -124
  182. package/.agent/workflows/debug.md +190 -165
  183. package/.agent/workflows/deploy.md +201 -180
  184. package/.agent/workflows/enhance.md +154 -128
  185. package/.agent/workflows/fix.md +136 -114
  186. package/.agent/workflows/generate.md +198 -183
  187. package/.agent/workflows/marathon.md +37 -11
  188. package/.agent/workflows/migrate.md +184 -160
  189. package/.agent/workflows/orchestrate.md +192 -168
  190. package/.agent/workflows/performance-benchmarker.md +135 -114
  191. package/.agent/workflows/plan.md +196 -173
  192. package/.agent/workflows/preview.md +103 -80
  193. package/.agent/workflows/refactor.md +192 -161
  194. package/.agent/workflows/review-ai.md +125 -101
  195. package/.agent/workflows/review.md +141 -116
  196. package/.agent/workflows/session.md +122 -94
  197. package/.agent/workflows/status.md +101 -79
  198. package/.agent/workflows/strengthen-skills.md +164 -138
  199. package/.agent/workflows/super-prompt.md +24 -0
  200. package/.agent/workflows/swarm.md +193 -179
  201. package/.agent/workflows/test.md +211 -189
  202. package/.agent/workflows/tribunal-backend.md +136 -105
  203. package/.agent/workflows/tribunal-database.md +129 -95
  204. package/.agent/workflows/tribunal-frontend.md +140 -96
  205. package/.agent/workflows/tribunal-full.md +131 -100
  206. package/.agent/workflows/tribunal-mobile.md +129 -95
  207. package/.agent/workflows/tribunal-performance.md +136 -110
  208. package/.agent/workflows/tribunal-speed.md +209 -183
  209. package/.agent/workflows/ui-ux-pro-max.md +155 -122
  210. package/README.md +107 -55
  211. package/mcp_config.json +1 -3
  212. package/package.json +94 -94
  213. package/.agent/GEMINI.md +0 -121
  214. package/.agent/skills/doc.md +0 -177
@@ -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.