How ahad-2004/boardly-hub works
Project Type and Purpose
• This is a full-stack, single-page application (“Digital Notice Board”) for educational institutions.
• Frontend: React + TypeScript + Vite + Tailwind + Shadcn/ui
• Backend-as-a-Service: Supabase (Authentication, Database, Realtime)
File Structure
• Top-level:
• src/ – React source code
• public/ – static assets (robots.txt, index.html)
• supabase/ – Supabase config.toml + SQL migrations
• Configuration: vite.config.ts, tailwind.config.ts, tsconfig, CI/CD workflow
• src/ subdirectories:
• components/ – reusable UI & domain components (NoticeCard, NoticeForm, plus Shadcn/ui primitives)
• pages/ – route-level views (Auth, StudentDashboard, FacultyDashboard)
• contexts/ – React context (AuthContext)
• hooks/ – custom hooks (use-mobile, use-toast)
• integrations/supabase – client.ts + types.ts for Supabase SDK initialization
• lib/ – business logic (notices.ts, utils.ts)
Extract Architectural Insights from README
• Two user roles: Faculty and Student
• Faculty → create/manage notices; Student → view filtered notices
• Real-time updates via Supabase Realtime
• Responsive & themable (dark mode) UI