How manavarya09/homestuco works
Project type and purpose
• This is a single-page, static web application built with React (Vite + TypeScript) and styled with Tailwind CSS.
• Its purpose is to showcase the BITS Pilani Dubai Campus Student Council: landing sections, member profiles, announcements, events, and a contact form that sends data to a Google Apps Script endpoint (which logs submissions to Google Sheets).
File structure
• Top-level files:
• package.json / package-lock.json: npm dependencies & scripts
• vite.config.ts, tsconfig*.json: build and TypeScript configuration
• tailwind.config.ts, postcss.config.js: styling pipeline
• public/: static assets (robots.txt, index.html is top-level)
• src/:
• main.tsx: application entry point, mounts App.tsx
• App.tsx / App.css: top-level component and global styles
• assets/: council photos and images
• components/: UI library (accordion, button, dialog, etc.) + page sections (HeroSection, AnnouncementSection, CouncilSection) + Navigation
• hooks/: custom React hooks (use-mobile, use-toast)
• lib/utils.ts: shared utility functions
• pages/: React Router pages (Index, About, Events, Merch, Contact with form, NotFound)
• There is no dedicated backend code in this repository; the only backend integration is the contact form’s external endpoint.
README for additional insights
• Contact form details: submits to a Google Apps Script endpoint; mentions CORS and proxy usage for production
• Deployment targets: Vercel, Netlify, or any static-hosting service with an optional proxy for the form
Detail without over-splitting
• Major components and interactions listed above
• Avoid drawing every single UI component file separately; group them logically (e.g., “UI Component Library”)