# Neo App Mode

> Build full-stack applications after collecting project requirements. Use when user says Neo App Mode, asks to build/create/scaffold a new app, or wants React+Vite+Tailwind frontend with Node/Express/MongoDB backend using MVC architecture.

- Skill: `dvcrn/neo-app-mode` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add dvcrn/neo-app-mode`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/neo-app-mode/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/neo-app-mode

---


# Neo App Mode

Collect requirements first, then scaffold a production-ready starter.

## Requirement intake (ask before scaffolding)

Ask these in one compact checklist:
1. Project name
2. App type and core modules (auth, dashboard, CRUD entities)
3. User roles (admin/user/etc.)
4. Required pages and API endpoints
5. MongoDB connection preference (local/Atlas)
6. Auth method (JWT/session/OAuth)
7. Extra features (file upload, charts, payments, notifications)

If user is unsure, use defaults from `references/default-requirements.md`.

## Generate app scaffold

Run:

```bash
bash skills/neo-app-mode/scripts/scaffold_neo_app.sh \
  --name <project-name> \
  --path apps \
  --with-auth jwt
```

Output structure:
- `frontend/` → React + Vite + Tailwind
- `backend/` → Express + MongoDB + MVC
- `.env.example` files for frontend/backend
- starter README with run steps

## Behavior rules

- Always confirm requirements summary before code generation.
- Use clean MVC in backend: `models/`, `controllers/`, `routes/`, `middlewares/`, `config/`.
- Add at least one sample entity module with full CRUD.
- Add health route and API prefix `/api/v1`.
- Keep generated code minimal, readable, and extendable.