# Fullstack Dev

Full-stack backend architecture and frontend-backend integration guide.

- Repository: https://github.com/MiniMax-AI/skills (13760 stars)
- Category: Design
- License: MIT
- Last updated: 2026-04-18
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add MiniMax-AI/skills --skill fullstack-dev -g -a claude-code -y`
Codex: `npx skills add MiniMax-AI/skills --skill fullstack-dev -g -a codex -y`
Cursor: `npx skills add MiniMax-AI/skills --skill fullstack-dev -g -a cursor -y`
Gemini CLI: `npx skills add MiniMax-AI/skills --skill fullstack-dev -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add MiniMax-AI/skills`

## Description

Full-stack backend architecture and frontend-backend integration guide. TRIGGER when: building a full-stack app, creating REST API with frontend, scaffolding backend service, building todo app, building CRUD app, building real-time app, building chat app, Express + React, Next.js API, Node.js backend, Python backend, Go backend, designing service layers, implementing error handling, managing config/auth, setting up API clients, implementing auth flows, handling file uploads, adding real-time features (SSE/WebSocket), hardening for production. DO NOT TRIGGER when: pure frontend UI work, pure CSS/styling, database schema only.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Full-Stack Development Practices

## MANDATORY WORKFLOW, Follow These Steps In Order

**When this skill is triggered, you MUST follow this workflow before writing any code.**

### Step 0: Gather Requirements

Before scaffolding anything, ask the user to clarify (or infer from context):

1. **Stack**: Language/framework for backend and frontend (e.g., Express + React, Django + Vue, Go + HTMX)
2. **Service type**: API-only, full-stack monolith, or microservice?
3. **Database**: SQL (PostgreSQL, SQLite, MySQL) or NoSQL (MongoDB, Redis)?
4. **Integration**: REST, GraphQL, tRPC, or gRPC?
5. **Real-time**: Needed? If yes, SSE, WebSocket, or polling?
6. **Auth**: Needed? If yes, JWT, session, OAuth, or third-party (Clerk, Auth.js)?

If the user has already specified these in their request, skip asking and proceed.

### Step 1: Architectural Decisions

Based on requirements, make and state these decisions before coding:

| Decision | Options | Reference |
|----------|---------|-----------|
| Project structure | Feature-first (recommended) vs layer-first | [Section 1](#1-project-structure--layering-critical) |
| API client approach | Typed fetch / React Query / tRPC / OpenAPI codegen | [Section 5](#5-api-client-patterns-medium) |
| Auth strategy | JWT + refresh / session / third-party | [Section 6](#6-authentication--middleware-high) |
| Real-time method | Polling / SSE / WebSocket | [Section 11](#11-real-time-patterns-medium) |
| Error handling | Typed error hierarchy + global handler | [Section 3](#3-error-handling--resilience-high) |

Briefly explain each choice (1 sentence per decision).

### Step 2: Scaffold with Checklist

Use the appropriate checklist below. Ensure ALL checked items are implemented, do not skip any.

### Step 3: Implement Following Patterns

Write code following the patterns in this document. Reference specific sections as you implement each part.

### Step 4: Test & Verify

After implementation, run these checks before claiming completion:

The rest: https://github.com/MiniMax-AI/skills/blob/HEAD/skills/fullstack-dev/SKILL.md