Modheshwari

Modheshwari is a full-stack community management platform for organizing families, events, resource requests, approvals, communications, and member discovery in a role-based environment. It combines a modern Next.js web app, a Bun-based backend API, and a realtime WebSocket service to support both administrative workflows and everyday community interaction.

What it does

• Manage family and member records across community hierarchies
• Support role-based access for community heads, subheads, gotra heads, family heads, and members
• Handle event creation, approval, registration, and status workflows
• Process resource requests with multi-step approvals
• Deliver in-app notifications and chat through a dedicated realtime service
• Provide search, discovery, and monitoring tooling for operational use

Tech stack

• Language: TypeScript
• Runtime: Bun
• Frontend: Vite, React 19, React Router, Tailwind CSS, Framer Motion
• Backend: Elysia, Prisma ORM, PostgreSQL
• Realtime: WebSocket service with Redis and Kafka
• Infrastructure: Docker Compose, Nginx, GitHub Actions, Prometheus/Grafana
• Search/Observability: Elasticsearch, Prometheus, Alertmanager

Architecture overview

flowchart LR
    A[Vite Web App] --> B[Backend API]
    A --> C[WebSocket Service]
    B --> D[(PostgreSQL)]
    B --> E[(Redis)]
    B --> F[Kafka]
    C --> E
    C --> F
    B --> G[Elasticsearch]
    H[Prometheus / Grafana] --> B
    H --> C

    subgraph Reliability Layer
        D -->|atomic write| I[Outbox Events]
        I -->|relay| F
        I -->|relay| G
    end

Loading

Getting started

1. Copy the environment template:

   cp .env.example .env

2. Install dependencies:

   bun install

3. Start the supporting services:

   docker compose up -d db redis zookeeper kafka

4. Apply database migrations:

   bunx prisma migrate dev --schema packages/db/schema.prisma

5. Start the full development stack:

   bun run dev

The web app will typically be available at http://localhost:3000, the backend at http://localhost:3001/api/health, and the websocket service at http://localhost:3002/health.

Demo credentials

If you seed the database with bun run db:seed, you can sign in with any of these demo accounts using the password demo123:

• [email protected] - community head
• [email protected] - community subhead
• [email protected] - gotra head
• [email protected] - family head
• [email protected] - member

Useful commands

• Run linting: bun run lint
• Run type checks: bun run check-types
• Generate docs: bun run docs:gen
• Generate OpenAPI: bun run openapi:gen
• Seed the database: bun run db:seed

Deployment and operations

• Containerized deployment is defined in docker-compose.yml
• CI/CD automation is defined in .github/workflows/deploy.yml
• Additional architecture context is available in design.md and ARCHITECTURE_MINIMAP.md

Release

Current release: v1.1.0

License

This project is licensed under the MIT License.