@longtq2501/next-spring-skills 1.3.0 → 1.4.0

package/AGENT.md

@@ -1,5 +1,8 @@
 # Agent Instructions
 
+> [!IMPORTANT]
+> **MANDATORY STARTUP STEP**: Upon starting a new session or entering this project, the AI Agent **MUST** immediately read `skills/SKILL.md` to index all available standards and architectural patterns. Do not proceed with code generation until you have understood the patterns in the `skills/` directory.
+
 Rules for contributing to this repository.
 
 ## Style Guidelines

package/README.md

@@ -1,5 +1,7 @@
 # Next-Spring Skills
 
+[![npm version](https://img.shields.io/npm/v/@longtq2501/next-spring-skills.svg)](https://www.npmjs.com/package/@longtq2501/next-spring-skills)
+
 Modular best practices, code templates, and interaction protocols for full-stack projects using **Next.js** and **Spring Boot**.
 
 ## Key Directories
@@ -11,6 +13,11 @@ Modular best practices, code templates, and interaction protocols for full-stack
 
 ---
 
+## NPM Package
+📦 **Registry**: [https://www.npmjs.com/package/@longtq2501/next-spring-skills](https://www.npmjs.com/package/@longtq2501/next-spring-skills)
+
+---
+
 ## Installation
 You can instantly add these skills to any project using `npx`:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtq2501/next-spring-skills",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Standardized best practices and code patterns for Next.js and Spring Boot",
   "bin": {
     "next-spring-skills": "bin/cli.js"

package/skills/SKILL.md

@@ -69,6 +69,9 @@ See [webrtc.md](./nextjs/webrtc.md) for real-time media and signaling.
 ### Quality Assurance
 See [testing.md](./nextjs/testing.md) for Vitest and React Testing Library patterns.
 
+### Architecture & Monorepo
+See [monorepo.md](./nextjs/monorepo.md) for Turborepo and code-sharing strategies.
+
 ### Accessibility (a11y)
 See [accessibility.md](./nextjs/accessibility.md) for semantic HTML and ARIA.
 

package/skills/nextjs/monorepo.md

@@ -0,0 +1,116 @@
+# Skill: Monorepo Management - Turborepo (Production Blueprint)
+
+Guidelines for building a scalable, high-performance monorepo for enterprise-level multi-platform projects.
+
+## TL;DR - Quick Reference
+
+### Critical Rules
+1. **Orchestration**: Use Turborepo for build pipeline and remote caching.
+2. **Modular Packages**: Extract logic to `packages/` to ensure 95%+ code reusability.
+3. **Internal Linking**: Use `workspace:*` for local package dependencies.
+4. **Consistency**: Share ESLint, Prettier, Tailwind, and TS configs across all apps.
+5. **Types First**: Shared DTOs in `packages/types` are the single source of truth for FE/BE sync.
+
+---
+
+## 1. Enterprise Directory Structure
+
+```text
+/my-monorepo/
+├── apps/                           # Deployable Applications
+│   ├── web/                        # Next.js 14 App Router
+│   ├── admin/                      # Admin Dashboard
+│   ├── mobile/                     # React Native (Expo)
+│   ├── desktop/                    # Electron
+│   └── api/                        # Spring Boot (Backend)
+├── packages/                       # Shared Domain Logic
+│   ├── ui/                         # Core UI (Shadcn/React)
+│   ├── types/                      # Shared Interfaces & DTOs
+│   ├── validators/                 # Zod/Validation Logic
+│   ├── utils/                      # Shared Helpers (Date, String)
+│   ├── api-client/                 # Axios/Fetch Wrapper
+│   └── database/                   # Prisma/DB Client
+├── infra/                          # Shared Configuration
+│   ├── tailwind-config/
+│   ├── eslint-config/
+│   └── typescript-config/
+├── turbo.json                      # Build Pipeline Config
+└── package.json                    # Workspace Definition
+```
+
+---
+
+## 2. Core Configurations
+
+### turbo.json (The Brain)
+Defines task dependencies and caching outputs.
+
+```json
+{
+  "$schema": "https://turbo.build/schema.json",
+  "pipeline": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": [".next/**", "dist/**", "out/**"]
+    },
+    "lint": {},
+    "test": {
+      "cache": true
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    }
+  }
+}
+```
+
+### package.json (The Workspace)
+Must include `workspaces` (npm/yarn) or `pnpm-workspace.yaml`.
+
+```json
+{
+  "private": true,
+  "workspaces": ["apps/*", "packages/*"],
+  "scripts": {
+    "dev": "turbo dev",
+    "build": "turbo build",
+    "test": "turbo test"
+  }
+}
+```
+
+---
+
+## 3. Shared Packages Pattern
+
+### How to share a package (ex: Types)
+1. Create `packages/types/package.json` with a scoped name like `@repo/types`.
+2. Export your types/interfaces from `index.ts`.
+3. In `apps/web/package.json`, add `"@repo/types": "workspace:*"`.
+
+// Good: Shared DTO Example
+export interface OrderDTO {
+  id: string;
+  status: 'PENDING' | 'DONE';
+  items: string[];
+}
+
+---
+
+## 4. Scaling & Efficiency
+
+### Remote Caching
+Enable `turbo login` and `turbo link` in CI/CD to share build artifacts across the team, reducing build times from minutes to seconds.
+
+### Monolith to Monorepo Migration
+- **Step 1**: Move your monolithic `src/` to `apps/main-app/`.
+- **Step 2**: Identify shared logic (utils, constants) and move them to `packages/`.
+- **Step 3**: Introduce internal packages and replace local imports with `@repo/...`.
+
+---
+
+## Related Skills
+- **Frontend Testing**: `skills/nextjs/testing.md`
+- **Performance**: `skills/nextjs/performance.md`
+- **Agent Workflow**: `skills/agent-workflow.md`