How thabetaltartoori/brainy-bunch works
Brainy Bunch is a bilingual school-management application centered on staff recording student notes and monthly payments, while parents sign in to view only their own children’s information. The React client calls a Node/Express API; server-side role checks scope access before domain routes use the selected in-memory or Supabase store. The README also documents test results, staff management, announcements, fee summaries, and Arabic/English RTL support. Several route and storage relationships are supported by the SOURCE INDEX rather than full excerpts; unshown wiring is left out.
Main entry points: App.jsx App routing · index.js Express application · api.js API client · access.js Role access and scoping
Components 30
Client experience
- App routing
client/src/App.jsx - Sign in
client/src/pages/Login.jsx - Student records
client/src/pages/Students.jsx - Student profile
client/src/pages/StudentProfile.jsx - Payments
client/src/pages/Payments.jsx - Notes
client/src/pages/Notes.jsx - Staff accounts
client/src/pages/Staff.jsx - Announcements
client/src/pages/Announcements.jsx - Dashboard
client/src/pages/Dashboard.jsx - API client
client/src/api.js - Language and formatting
client/src/i18n.jsx - Navigation and banner
client/src/components/Shell.jsx
API and domain
- Express application
server/src/index.js - Authentication routes
server/src/routes/auth.js - Student routes
server/src/routes/students.js - Notes routes
server/src/routes/notes.js - Payment routes
server/src/routes/payments.js - Assessment routes
server/src/routes/assessments.js - User routes
server/src/routes/users.js - Meta and fee data
server/src/routes/meta.js - Role access and scoping
server/src/access.js - Password and sessions
server/src/auth.js - Fee summaries
server/src/fees.js - HTTP validation
server/src/http.js
Persistence
- Demo store
server/src/store/memory.js - Supabase store
server/src/store/supabase.js - Demo seed data
server/src/store/seed.js
Runtime adapters
- Cloudflare adapter
worker/index.js - Netlify function adapter
server/netlify/functions/api.mjs
Other components
- School users
Connections 48
- School users → App routing: use
client/src/App.jsx - App routing → Sign in: routes to
client/src/App.jsx - App routing → Dashboard: routes to
client/src/App.jsx - App routing → Student records: routes to
client/src/App.jsx - App routing → Student profile: routes to
client/src/App.jsx - App routing → Payments: routes to
client/src/App.jsx - App routing → Notes: routes to
client/src/App.jsx - App routing → Staff accounts: routes to
client/src/App.jsx - App routing → Announcements: routes to
client/src/App.jsx - Sign in → API client: calls
client/src/pages/Login.jsx - Student records → API client: calls
client/src/pages/Students.jsx - Student profile → API client: calls
client/src/pages/StudentProfile.jsx - Payments → API client: calls
client/src/pages/Payments.jsx - Notes → API client: calls
client/src/pages/Notes.jsx - Staff accounts → API client: calls
client/src/pages/Staff.jsx - Announcements → API client: calls
client/src/pages/Announcements.jsx - App routing → Language and formatting: provides
client/src/App.jsx - App routing → Navigation and banner: uses
client/src/App.jsx - API client → Express application: requests API
- Express application → Authentication routes: registers
server/src/index.js - Express application → Student routes: registers
server/src/index.js - Express application → Notes routes: registers
server/src/index.js - Express application → Payment routes: registers
server/src/index.js - Express application → Assessment routes: registers
server/src/index.js - Express application → User routes: registers
server/src/index.js - Express application → Meta and fee data: registers
server/src/index.js - Express application → Demo store: selects store
server/src/index.js - Express application → Supabase store: selects store
server/src/index.js - Express application → Password and sessions: parses sessions
server/src/index.js - Authentication routes → Password and sessions: uses
server/src/routes/auth.js - Authentication routes → Role access and scoping: checks access
server/src/routes/auth.js - Student routes → Role access and scoping: scopes records
server/src/routes/students.js - Student routes → Fee summaries: summarizes fees
server/src/routes/students.js - Notes routes → Role access and scoping: checks access
server/src/routes/notes.js - Payment routes → Role access and scoping: checks access
server/src/routes/payments.js - Assessment routes → Role access and scoping: checks access
server/src/routes/assessments.js - User routes → Role access and scoping: checks access
server/src/routes/users.js - User routes → Password and sessions: uses
server/src/routes/users.js - Meta and fee data → Role access and scoping: checks access
server/src/routes/meta.js - Meta and fee data → Fee summaries: uses
server/src/routes/meta.js - Authentication routes → HTTP validation: uses
server/src/routes/auth.js - Student routes → HTTP validation: uses
server/src/routes/students.js - Notes routes → HTTP validation: uses
server/src/routes/notes.js - Payment routes → HTTP validation: uses
server/src/routes/payments.js - Assessment routes → HTTP validation: uses
server/src/routes/assessments.js - User routes → HTTP validation: uses
server/src/routes/users.js - Meta and fee data → HTTP validation: uses
server/src/routes/meta.js - Role access and scoping → Fee summaries: summarizes
server/src/access.js