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