Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Latest commit

 

History

History
90 lines (65 loc) · 1.93 KB

File metadata and controls

90 lines (65 loc) · 1.93 KB

Society Platform

Society management software built for Indian residential societies. Builder-first. Operational in 30 minutes. No ads. No data selling.


What It Does

  • Builder sets up a society before handover to residents
  • Admin manages members, complaints, announcements
  • Residents raise complaints, approve visitors, book amenities
  • Gatekeeper manages physical entry with real-time resident approval

Who It's For

Small to medium societies: 20 to 200 units. Builders managing new residential projects. Societies currently running on WhatsApp groups and physical registers.


Stack

Backend:   Node.js + Express + TypeScript + Prisma + PostgreSQL
Web:       React + TypeScript
Mobile:    React Native + TypeScript
Monorepo:  Turborepo

Full details in docs/STACK.md


Getting Started

See docs/SETUP.md for complete local setup instructions.

Quick version:

git clone https://github.com/inspirebyte-tech/society-platform.git
cd society-platform
npm install
cd apps/api
cp .env.example .env
# fill in .env values
npx prisma migrate reset
npx tsx src/index.ts

Documentation

docs/ARCHITECTURE.md   → system design and why
docs/FEATURES.md       → what the app does per role
docs/PERMISSIONS.md    → every permission string and role bundle
docs/STACK.md          → tech choices and reasoning
docs/DECISIONS.md      → architectural decision log
docs/SETUP.md          → local development setup

Branch Strategy

main        → stable, protected, PRs only
dev         → integration branch, all features merge here
feature/*   → individual feature work
fix/*       → bug fixes

Never push directly to main or dev. Always create a branch, always open a PR.


Project Status

Currently in active development. V1 target: Core society management features. See GitHub Projects board for current progress.


Team

Built by Inspirebyte.