메뉴
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 |