How asiet-iedc/iedc-website works
1. This repository is a Next.js App Router frontend, centered on a small set of content pages rather than a backend-heavy application. The main routes are app/page.tsx, about, contact, events, excom, and gallery.
2. The routing layer is file-based under app/. Each route has its own page.tsx, and events and gallery also have loading.tsx, which suggests those sections may render heavier content or media and benefit from route-level suspense/loading states.
3. app/layout.tsx is the global shell for the site. It likely wires together shared chrome and app-wide providers, while components/navbar.tsx and components/footer.tsx provide the persistent navigation and footer across all pages.
4. The repository is structured like a presentation site with centralized content. data/data.tsx is the main place where structured page content, lists, or metadata likely lives, and the page components consume that data to render the route views.
5. The design system is split into a reusable UI layer under components/ui/. This is a large shadcn-style component library: buttons, dialogs, menus, sheets, tabs, tables, form controls, toasts, tooltips, and other primitives that page-specific components can compose.
6. Interactivity is lightweight and client-side. The main shared hooks are hooks/use-mobile.tsx for responsive behavior and hooks/use-toast.ts for notifications, with matching toast UI in components/ui/toaster.tsx and components/ui/sonner.tsx.
7. A theme boundary exists through components/theme-provider.tsx, indicating the site supports global theming, likely including dark/light mode, at the application shell level.
8. Static media is a major part of the architecture. The public/images tree is organized by site section (About, Events, Gallery, excom, thumbnails), and public/videos contains multiple MP4 assets plus a nested project demo folder. This means visual content is served directly from the public filesystem rather than from an API or CMS.
9. Styling is handled with Tailwind and global CSS. The repo includes tailwind.config.ts, postcss.config.mjs, app/globals.css, and styles/globals.css, so the visual system is built from utility classes plus shared global styles.
10. The overall data flow is: route page -> shared content/data -> reusable UI components -> static media from public/ -> global layout/theme/navigation/footer. There is no visible server, database, or external service layer in the tree, so the architecture is mostly a static, component-driven site rendered by Next.js.
Main entry points: layout.tsx Root layout · data.tsx Content data · ui UI primitives · page.tsx Events page
Components 21
App routes
File-based Next.js App Router pages and route shells.
- Root layout · Global site shell and shared providers.
app/layout.tsx - Home page · Landing route for the site.
app/page.tsx - About page · About section route.
app/about/page.tsx - Contact page · Contact section route.
app/contact/page.tsx - Events page · Events section route with loading state.
app/events/page.tsx - Events loading · Route-level loading UI for events.
app/events/loading.tsx - Excom page · Executive committee route.
app/excom/page.tsx - Gallery page · Gallery section route with loading state.
app/gallery/page.tsx - Gallery loading · Route-level loading UI for gallery.
app/gallery/loading.tsx
Shared site
Reusable chrome, theming, and content consumed across routes.
- Navbar · Persistent primary navigation.
components/navbar.tsx - Footer · Persistent site footer.
components/footer.tsx - Theme provider · Global theme and color-mode wiring.
components/theme-provider.tsx
UI kit
Composable shadcn-style primitives and helpers.
- UI primitives · Reusable visual and interaction building blocks.
components/ui - Toast system · Toast providers and notification hooks.
components/ui/toaster.tsx - Mobile hook · Shared responsive breakpoint helper.
components/ui/use-mobile.tsx
Content
Structured page data and static media assets.
- Content data · Central structured site content and metadata.
data/data.tsx - Image assets · Section-organized images served from public.
public/images - Video assets · Video library served from public.
public/videos
Styling
Global Tailwind and CSS configuration.
- Global CSS · App-wide stylesheet entrypoints.
app/globals.css - Shared styles · Additional global styling layer.
styles/globals.css - Tailwind config · Utility-first styling configuration.
tailwind.config.ts
Connections 30
- Root layout → Theme provider: wraps · Root layout provides app-wide theming.
- Root layout → Navbar: includes · Shared navigation is mounted in the shell.
- Root layout → Footer: includes · Shared footer is mounted in the shell.
- Root layout → Global CSS: loads · Global stylesheet is applied at the app root.
- Root layout → Shared styles: loads · Additional site styling is available globally.
- Root layout → Home page: routes to · Root shell serves the home route.
- Root layout → About page: routes to · Root shell serves the about route.
- Root layout → Contact page: routes to · Root shell serves the contact route.
- Root layout → Events page: routes to · Root shell serves the events route.
- Root layout → Gallery page: routes to · Root shell serves the gallery route.
- Root layout → Excom page: routes to · Root shell serves the excom route.
- Events page → Events loading: fallback · Events route has its own loading UI.
- Gallery page → Gallery loading: fallback · Gallery route has its own loading UI.
- Home page → Content data: reads · Home page consumes centralized content.
- About page → Content data: reads · About page consumes centralized content.
- Contact page → Content data: reads · Contact page consumes centralized content.
- Events page → Content data: reads · Events page consumes centralized content.
- Gallery page → Content data: reads · Gallery page consumes centralized content.
- Excom page → Content data: reads · Excom page consumes centralized content.
- Content data → Image assets: references · Structured content points to section images.
- Content data → Video assets: references · Structured content points to video assets.
- Home page → UI primitives: composes · Pages are built from shared UI primitives.
- About page → UI primitives: composes · Pages are built from shared UI primitives.
- Events page → UI primitives: composes · Pages are built from shared UI primitives.
- Gallery page → UI primitives: composes · Pages are built from shared UI primitives.
- UI primitives → Toast system: includes · Primitive set includes notification infrastructure.
- UI primitives → Mobile hook: uses · Primitive components can adapt to mobile layout.
- Toast system → Root layout: mounted by · Toast UI is expected to be mounted in the global shell.
- Tailwind config → UI primitives: styles · Tailwind config supports the shared component kit.
- Global CSS → Tailwind config: works with · Global CSS and Tailwind define the styling layer.