Skip to content

akshitjmsb/inner-circle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

511 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Inner Circle

Apna mohalla, digital ho gaya.

A social sharing app for 90s Indian kids — and everyone who grew up borrowing things from neighbours without a second thought.

Live → inner-circle-ten.vercel.app


The Problem

The average person buys 24 items a year they'll use fewer than twice. Multiply that across your close friends — that's a shared inventory worth hundreds of dollars, sitting idle and invisible in flats and garages.

We used to solve this naturally. You'd knock on a neighbour's door. You'd ask bhai yaar ke paas hai kya. The mohalla knew what it had.

Inner Circle makes that visible again.


What's Inside

🏠 Your Circle

Add items you're willing to share — power tools, camping gear, that blender you use twice a year. Your circle sees what you have. You see what they have. Borrow without the awkwardness of asking cold.

💬 Charcha

Real-time chat powered by Pusher. Your circle's own adda — presence, live notifications, the whole thing.

🎮 Khel (Games)

Multiplayer games built for your circle:

  • Raja Mantri Chor Sipahi — real-time, synced across devices
  • Saamp Seedhi — Snakes & Ladders with your circle, coming soon
  • Battle City — 2-4 player tanks, in the backlog

📚 Nostalgia Shelf

For the 90s kid in everyone. Amar Chitra Katha, Chacha Chaudhary, Doordarshan classics, Jungle Book, Malgudi Days — official/licensed sources only. Building toward an in-app reader.

🏃 Runs

Coordinate group activities. Plan runs, track who's in.

📅 Events (Hulchul)

Create events for the circle — RSVPs, reminders, the works.


Design System

Warm, South Asian. No cold blues or sterile whites.

Token Feel
Silk Warm off-white base
Gold Accent, CTAs
Kolam Deep jewel tone
Kumkum Red-orange highlight
Turmeric Warm yellow
Ink Primary text

Fonts: Playfair Display (display) · Plus Jakarta Sans (body)

Icons: Custom illustrated SVGs — tiffin dabba, vintage bicycle, lattu, akashdeep. No flat icon sets.

Voice: Plain English for CTAs, Hinglish for personality. Friendly elder brother, never patronising. "Picture abhi baaki hai."


Stack

Layer Tech
App Next.js 14 (App Router) · TypeScript · Tailwind CSS
Database Neon Postgres · Drizzle ORM
Auth Auth.js · Google OAuth · Magic Links (Brevo)
Realtime Pusher Channels
Media Cloudinary
Email Brevo
Hosting Vercel (PWA, Edge middleware, Cron)

Mobile-only PWA. 100% of users are on phones.


How It's Built — AI Agents

This project is built with AI coding agents (Claude Code · Codex). I act as Product Owner: I define the spec, own architecture decisions, review every change. Agents write the code.

The repo ships with a full agent governance layer:

File Purpose
CLAUDE.md Agent contract — locked icon style, locked copy tone, tech stack
ARCHITECTURE.md Layer map, service responsibilities, allowed imports, realtime/cron flow
tests/architecture-boundaries.test.ts Enforced import boundaries — agents can't break the layering
PRODUCT_BACKLOG.md Prioritized backlog — agents know what's next
OPERATIONS.md Release checklist, incident history

Two things are locked and agents cannot change them:

  • The icon style (illustrated, warm-toned fills, cultural motifs — not flat icons)
  • The copy tone (Hinglish personality, respect-first, tum/aap form always)

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com


Architecture

Feature-first, agent-friendly. Every feature owns its server/queries.ts, server/commands.ts, policies.ts, and types.ts. Route files stay thin. Agents can modify one feature without reading the whole app.

See ARCHITECTURE.md for the full service map, layer rules, and data flow.


Share what you have. Borrow what you need. Trust your circle.

About

Community borrowing platform — share what you have, borrow what you need from people you trust

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages