菜单
Get started with CampusOS development. Use when setting up the local environment, making a first contribution, troubleshooting setup issues, or understanding project structure.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Build React components in Next.js using CampusOS patterns. Use when implementing UI components, working with the App Router, styling with Tailwind CSS v4, or managing forms with react-hook-form and Zod.
Comprehensive frontend development hub — UI/UX design, React/Next.js patterns, Tailwind CSS v4, shadcn/ui components, Three.js 3D graphics, creative web experiences, data visualization, diagramming, Figma integration, accessibility, game development, scroll animations, and design systems. Use for ANY frontend task: building components, designing interfaces, styling, theming, animations, charts, responsive layouts, mobile design, or implementing design patterns.
Clarify requirements before implementing. Do not use automatically, only when invoked explicitly.
Use when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync.
Generate commit titles and descriptions from uncommitted changes. Use when the user asks to generate a commit message, wants help writing a commit, or says 'commit', 'commit message', 'what should I commit', or similar.
Generate PR titles and descriptions from commit history. Use when the user asks to generate a PR description, wants help writing a pull request, provides commit titles/messages, or says 'PR', 'pull request', 'PR description', or similar.
| name | developer-onboarding |
| description | Get started with CampusOS development. Use when setting up the local environment, making a first contribution, troubleshooting setup issues, or understanding project structure. |
git clone https://github.com/NITRR-Official/CampusOS.git
cd CampusOS
# Check versions (Node 18+, pnpm 8+)
node --version
pnpm --version
# Install dependencies
pnpm install
# Setup environment
cp .env.example .env.local
# Edit .env.local with required values (MONGODB_URI, JWT_SECRET)
# 1. Start MongoDB (required)
docker run -d -p 27017:27017 --name mongodb mongo:latest
# 2. Start all services
pnpm dev
# Frontend: http://localhost:3000
# Backend: http://localhost:4000
# Health: http://localhost:4000/health
CampusOS/
├── frontend/ # Next.js 16 (App Router, React 19, TypeScript)
│ ├── app/ # Pages & layouts
│ ├── components/ # Shared + shadcn/ui components
│ └── lib/ # API clients, utilities, validations
├── backend/ # Express v5 server
│ └── src/
│ ├── middleware/ # Auth, RBAC, logger, error handler
│ ├── database/ # Mongoose connection + schemas
│ └── utils/ # Service registry
├── apps/ # Plugin modules
│ ├── auth/ # Authentication
│ ├── club/ # Club management
│ ├── event/ # Event management
│ ├── vendor/ # Vendor management
│ ├── resource/ # Resource management
│ ├── scheduling/ # Scheduling
│ └── budget/ # Budget management
└── docs/ # Documentation (source of truth)
git checkout -b feature/<issue>-<description>
# Make changes following docs/contributing/CODING_GUIDELINES.md
# Run checks
pnpm lint
pnpm -C apps/<module> test -- --run
# Commit with Conventional Commits
git commit -m "feat: add new feature"
# Push and create PR
git push origin feature/<issue>-<description>
gh pr create --fill
import/export, never require()pnpm dev # Start everything
pnpm lint # Code quality
pnpm -C apps/vendor test -- --run # Run tests
pnpm build # Build all
| Issue | Solution |
|---|---|
| pnpm not found | npm install -g pnpm@8 |
| Port in use | Check for existing processes on 3000/4000 |
| DB connection fails | docker start mongodb — check MONGODB_URI |
| Module not found | Run pnpm install from root |