fullstacknextjs
Collection of skills for full-stack Next.js development with Clean Architecture and AWS serverless. Backend uses Entities, Use Cases, Repository pattern, and DI Container. Frontend uses thin server action adapters.
Resources
13Install
npx skillscat add gilbertopsantosjr/fullstacknextjs/fullstacknextjs Install via the SkillsCat registry.
A collection of skills for building full-stack Next.js applications using Clean Architecture and AWS serverless, covering domain modules, DynamoDB repositories, server actions, validation, UI components, testing, and SST deployment. It provides structured guidance for implementing features layer by layer while enforcing separation of concerns. Developers should use it when scaffolding or maintaining Next.js projects that require Clean Architecture patterns with serverless AWS backends.
Full-Stack Next.js Skills (Clean Architecture)
Umbrella skill containing specialized skills for Next.js + AWS serverless with Clean Architecture patterns.
Available Skills
| Skill | Use When |
|---|---|
| gs-feature-architecture | Planning features, understanding Clean Architecture layers |
| gs-create-domain-module | Scaffolding new domain modules (Entity, Use Case, Repository) |
| gs-dynamodb-onetable | Repository implementations with DynamoDB OneTable |
| gs-nextjs-server-actions | Creating thin server action adapters |
| gs-zod-validation | Input validation schemas (presentation layer only) |
| gs-nextjs-web-client | Building UI components with DTOs |
| gs-tanstack-react-query | Data fetching with React Query |
| gs-create-e2e-tests | Testing by Clean Architecture layer |
| gs-sst-infra | AWS deployment with SST v3 |
| gs-bun-aws-lambda | Lambda handlers with Clean Architecture |
| gs-evaluate-domain-module | Assessing module compliance |
| gs-modularity-maturity-assessor | Codebase maturity scoring |
| gs-santry-observability | Sentry integration per layer |
Quick Start (New Feature)
Follow this order when implementing new features:
- gs-create-domain-module - Scaffold Entity, Repository interface, Use Case, DTO
- gs-dynamodb-onetable - Implement Repository with OneTable
- gs-zod-validation - Define input schemas for actions
- gs-nextjs-server-actions - Create thin action adapters
- gs-nextjs-web-client - Build UI components
- gs-create-e2e-tests - Write tests by layer
- gs-sst-infra - Deploy changes
Architecture Layers
┌─────────────────────────────────────────┐
│ Presentation (Next.js, Actions, UI) │
├─────────────────────────────────────────┤
│ Application (Use Cases, DTOs) │
├─────────────────────────────────────────┤
│ Domain (Entities, Repository Interfaces)│
├─────────────────────────────────────────┤
│ Infrastructure (DynamoDB, External APIs)│
└─────────────────────────────────────────┘Dependency Rule: Inner layers NEVER import from outer layers.
Tech Stack
- Frontend: Next.js 15+, React 19+, Shadcn UI, Tailwind CSS
- Backend: Clean Architecture (Entities, Use Cases, Repositories)
- Database: DynamoDB (single-table), OneTable ORM
- Actions: ZSA (thin adapters to Use Cases)
- DI: Custom DI Container with token registration
- Auth: Better Auth
- Infrastructure: SST v3, AWS Lambda, CloudFront
- Validation: Zod (presentation) + Entity.validate() (domain)
Categories
Install
npx skillscat add gilbertopsantosjr/fullstacknextjs/fullstacknextjs Install via the SkillsCat registry.