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