How fossuchennai/communities works
Tamilnadu.tech is a Tamil Nadu technology-event and community hub. Users discover current events and communities, inspect archived events, add events to calendars, consume RSS feeds, and optionally receive push notifications. The sampled code clearly supports browser subscription management, GitHub-backed subscription dispatch, service-worker notification handling, and RSS generation with GitHub fallback. Event and community JSON files are referenced by source but are absent from the supplied tree, so they are represented through their consuming components rather than as storage nodes.
Main entry points: PushSubscribe.tsx Push Subscribe · sw.js Push Service Worker · page.tsx Home Page · events.tsx Event Listings
Components 17
Discovery Experience
- Home Page
src/app/page.tsx - Event Listings
src/components/pages/home/events.tsx - Community Directory
src/app/communities/page.tsx - Community View
src/components/pages/Communities/Community.tsx - Event Archive
src/components/pages/Archive/archive.tsx - Calendar Action
src/components/AddToCalendar.tsx
Event Syndication
- Public RSS
src/app/rss/route.ts - API RSS
src/app/api/rss/route.ts
Push Notifications
- Push Subscribe
src/components/PushSubscribe.tsx - Push Service Worker
public/sw.js - Save Subscription
src/app/api/save-subscription/route.ts - Remove Subscription
src/app/api/remove-subscription/route.ts - Web Push Utility
src/lib/webpush.ts
Platform Routes
- Health Endpoint
src/app/api/route.ts
Other components
- Visitor
- GitHub API
- Push Network
Connections 19
- Visitor → Home Page: opens
- Visitor → Community Directory: browses
- Visitor → Event Archive: reviews past
- Home Page → Event Listings: renders
- Community Directory → Community View: renders
- Event Listings → Calendar Action: offers dates
- Visitor → Public RSS: requests feed
- Visitor → API RSS: requests feed
- API RSS → GitHub API: fetches events
- Visitor → Push Subscribe: enables alerts
- Push Subscribe → Push Service Worker: registers
- Push Subscribe → Save Subscription: saves subscription
- Push Subscribe → Remove Subscription: removes subscription
- Save Subscription → GitHub API: dispatches save
- Remove Subscription → GitHub API: dispatches removal
- Web Push Utility → Push Network: sends notifications
- Push Network → Push Service Worker: delivers push
- Push Service Worker → Visitor: shows alert
- Visitor → Health Endpoint: checks status