UniDorm is a university dormitory management system for Visayas State University, rebuilt with strict role access contracts and a .maba feature-branch execution roadmap.

• Next.js 16 (App Router)
• TypeScript
• Tailwind CSS v4
• shadcn/ui
• Supabase (Auth, Postgres, RLS)

1. Install dependencies:

npm install

2. Create local environment file:

cp .env.example .env.local

3. Set required values in .env.local:

• NEXT_PUBLIC_SUPABASE_URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY
• SUPABASE_SERVICE_ROLE_KEY

4. Run the development server:

npm run dev

5. Open http://localhost:3000.

• npm run dev - start local development server
• npm run lint - run ESLint
• npm run typecheck - run TypeScript no-emit checks
• npm run build - create production build

• Supabase helper clients are initialized in:
  • src/lib/supabase/client.ts
  • src/lib/supabase/server.ts
  • src/lib/supabase/admin.ts
• Planning and branch execution guides are in .maba/.

• Base branches: main, develop
• Feature branches: feature/<slug>
• Merge policy: merge commit only (--no-ff), no squash

Current implementation track starts with feature/foundation-platform.