Promote the talent graph's implicit structure to an explicit schema and add the single guardrail that removes hallucinated structure: validate every candidate edge against its edge type's domain/range and reject type-incompatible ones. - talentGraphOntology.ts: node types (developer, repo, org, skill, contribution) and edge types (contributed_to, member_of, has_skill, collaborated_with) with domain/range, symmetry and reflexivity rules. validateEdge / validateEdges vet untrusted edges, require provenance (source, observedAt, confidence) on every fact, dedup symmetric edges, and return typed rejection reasons. Pure, no I/O. - talentGraphEdges.ts: extraction step — turns getTalentGraph's view into provenanced candidate edges, reusing canonicalizeSkill and the evidence source union aligned with TalentEvidence.kind. - tests: 15 unit tests covering domain/range rejection, provenance validation, symmetric dedup, and extract-then-validate soundness.
🚀 Gitgram
Instagram-like social platform for developers - Share projects, connect through code, and build your developer network.
🎉 ALL 7 PHASES COMPLETE - READY TO LAUNCH! 🎉
✨ Features
🔐 Authentication
- Email/Password registration & login
- OAuth (GitHub & Google)
- JWT authentication with refresh tokens
- Email verification & password reset
📱 Social Features
- User profiles with avatars
- Follow/Unfollow system
- Posts (photos, videos, multi-photo)
- Stories (24h expiry) with reactions & replies
- Reels (vertical video)
- Comments & Likes
- Real-time messaging
- Notifications
🎯 Discovery
- Explore page
- Hashtag pages & trending
- Search (users, posts, hashtags)
- Suggested users
- Collections (organize saved posts)
💻 GitHub Integration
- OAuth login
- Project sync
- Repository links
- Developer profiles
- Account claiming
🎨 UI/UX
- Dark mode
- Responsive design
- Infinite scroll
- Image carousel
- Video player
- Emoji picker
- Skeleton loaders
- Error boundaries
- Empty states
📱 Mobile App
- 150+ screens
- Camera integration
- Push notifications
- Offline support
- Biometric auth
- Most core feature flows implemented; some mobile-only account flows are still placeholders (see
gitgram/mobile/app/**TODO markers).
💰 Monetization
- Subscription plans (Free, Premium, Creator)
- Polar.sh payment integration
- Advanced analytics dashboard
- Content scheduling
- Advertising platform
- Creator tools
🏗️ Architecture
Backend
- Runtime: Node.js + Express
- Database: PostgreSQL + Prisma ORM
- Real-time: Socket.io
- Storage: AWS S3 / Cloudinary
- Email: Resend
- Caching: Redis
- Monitoring: Sentry
Frontend Web
- Framework: Next.js 14 (App Router)
- Styling: Tailwind CSS
- State: Zustand
- Real-time: Socket.io Client
Mobile
- Framework: React Native + Expo
- Navigation: React Navigation
- State: Zustand
🚀 Quick Start
Prerequisites
- Node.js >= 18.0.0
- PostgreSQL
- Redis (optional)
Installation
# Install all dependencies
npm run install:all
# Set up environment variables
cp backend/.env.example backend/.env
cp web/.env.example web/.env.local
# Run database migrations
cd backend
npx prisma migrate dev
cd ..
# Start development servers
npm run dev
Development URLs
- Frontend (Next.js): http://localhost:3000
- Backend (Express API): http://localhost:4000
- API Docs (dev only): http://localhost:4000/api-docs
Notes:
- The backend port is controlled by
PORT. In the monorepodocker-compose.ymlit's set to4000. - The frontend port is controlled by Next.js (
3000by default).
📦 Project Structure
gitgram/
├── backend/ # Node.js + Express + Prisma
│ ├── src/
│ │ ├── controllers/ # 15+ controllers
│ │ ├── routes/ # 100+ endpoints
│ │ ├── middleware/ # Auth, rate limiting, caching
│ │ ├── services/ # Redis, Sentry, storage
│ │ └── websocket/ # Socket.io real-time
│ └── prisma/
│ └── schema.prisma # 22 database models
├── web/ # Next.js 14 web app
│ ├── app/ # 35+ pages
│ ├── components/ # 55+ components
│ ├── services/ # API clients
│ └── hooks/ # Custom hooks
├── mobile/ # React Native + Expo
│ ├── app/ # 150+ screens
│ └── services/ # 27 API services
└── scripts/ # Deployment & utility scripts
📊 Statistics
- Features: 85+ completed
- Backend: 110+ API endpoints, 27 models
- Frontend: 40+ pages, 60+ components
- Mobile: 150+ screens, 27 services
- Code: 30,000+ lines
- Progress: 100% complete
🛠️ Available Scripts
Root Level
npm run install:all # Install all dependencies
npm run dev # Start backend + web
npm run dev:all # Start all (backend + web + mobile)
npm run build # Build backend + web
npm run test # Run all tests
npm run lint # Lint all projects
Backend
cd backend
npm run dev # Start dev server
npm run build # Build for production
npm start # Start production server
npm run prisma:migrate # Run database migrations
npm run prisma:studio # Open Prisma Studio
Frontend
cd web
npm run dev # Start dev server
npm run build # Build for production
npm start # Start production server
npm run test # Run Vitest suite
npm run test:e2e # Run Playwright suite
npm run test:e2e:repo-text # Run focused repo routing/text browser gate
Mobile
cd mobile
npm start # Start Expo
npm run android # Run on Android
npm run ios # Run on iOS
🚀 Deployment
Quick Deploy
./scripts/deploy.sh
Manual Deploy
Backend (Railway)
cd backend
npm install
npx prisma generate
npx prisma migrate deploy
npm run build
npm start
Frontend (Vercel)
cd web
npm install
npm run build
vercel --prod
See DEPLOYMENT_GUIDE.md for detailed instructions.
📝 Documentation
- Deployment Guide - Complete deployment walkthrough
- Next Actions - Step-by-step action plan
- MVP Launch Checklist - 4-week launch plan
- Implementation Roadmap - Feature roadmap
- Final Status - Comprehensive status report
🧪 Testing
# Run all tests
npm test
# Backend tests
cd backend && npm test
# Frontend tests
cd web && npm test
# Mobile tests
cd mobile && npm test
🔒 Security
- JWT authentication with refresh tokens
- Rate limiting (5/min auth, 100/min API)
- CORS protection
- Security headers (Helmet)
- Input validation
- SQL injection prevention
- XSS prevention
- CSRF protection
💰 Cost Estimate
Free Tier
- Supabase: $0 (500MB database)
- Vercel: $0 (100GB bandwidth)
- Upstash: $0 (10K commands/day)
- Sentry: $0 (5K errors/month)
- Resend: $0 (3K emails/month)
- Railway: $5 (backend hosting)
Total: $5/month
🤝 Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📄 License
ISC License - see LICENSE file for details
🙏 Acknowledgments
- Next.js team for the amazing framework
- Prisma team for the excellent ORM
- Expo team for React Native tooling
- All open source contributors
📞 Support
- Documentation: /docs
- Issues: GitHub Issues
- Email: support@gitgram.app
🎯 Roadmap
- Core social features
- Real-time messaging
- GitHub integration
- Mobile app
- Dark mode
- Monetization (subscriptions, ads)
- Two-factor authentication
- Content moderation AI
- Advanced AI features
Built with ❤️ by developers, for developers
Last Updated: November 30, 2025
gitgram/
├── backend/ # Node.js + Express + Prisma backend
├── mobile/ # React Native + Expo mobile app
├── web/ # Next.js web application
├── scripts/ # Utility scripts for project management
└── package.json # Root package.json with centralized scripts
🚀 Quick Start
Prerequisites
- Node.js >= 18.0.0
- npm >= 9.0.0
- PostgreSQL (for backend)
- Expo CLI (for mobile development)
Installation
Install all dependencies for all projects:
npm run install:all
Or use the installation script:
chmod +x scripts/install-all.sh
./scripts/install-all.sh
Development
Start development servers:
npm run dev # Backend + Web (recommended)
npm run dev:all # Backend + Web + Mobile (all projects)
Or use the scripts:
./scripts/dev.sh # Backend + Web
./scripts/dev-all.sh # All projects
Or start specific projects:
npm run dev:backend # Backend only (port 3000)
npm run dev:web # Web only (port 3001)
npm run dev:mobile # Mobile (Expo)
Production Build
Build all projects:
npm run build # Backend + Web
npm run build:all # Backend + Web + Mobile
Build specific projects:
npm run build:backend
npm run build:web
npm run build:mobile
Production Start
Start production servers:
npm start # Backend + Web (production mode)
Or use the script:
./scripts/start.sh # Backend + Web (auto-builds if needed)
Note: Make sure to build projects first with npm run build before starting production servers.
📦 Package Management
Add a package
Add a package to a specific project:
npm run add:backend <package-name>
npm run add:mobile <package-name>
npm run add:web <package-name>
Or use the script:
./scripts/add-package.sh backend express
./scripts/add-package.sh mobile react-native-vector-icons
./scripts/add-package.sh web next-auth
Add a dev dependency:
./scripts/add-package.sh backend jest --dev
Remove a package
npm run remove:backend <package-name>
npm run remove:mobile <package-name>
npm run remove:web <package-name>
Or use the script:
./scripts/remove-package.sh backend express
🧹 Cleanup
Clean all build artifacts and node_modules:
npm run clean:all
Or use the script:
./scripts/clean-all.sh
🧪 Testing
Run all tests:
npm test
Run tests for specific projects:
npm run test:backend
npm run test:mobile
Watch mode:
npm run test:watch
🔍 Linting
Lint all projects:
npm run lint
Fix linting issues:
npm run lint:fix
🗄️ Database
Generate Prisma client:
npm run prisma:generate
Run migrations:
npm run prisma:migrate
Open Prisma Studio:
npm run prisma:studio
📝 Available Scripts
Installation
install:all- Install dependencies for all projectsinstall:backend- Install backend dependenciesinstall:mobile- Install mobile dependenciesinstall:web- Install web dependencies
Development
dev- Start backend and web (parallel)dev:all- Start all projects (parallel)dev:backend- Start backend onlydev:mobile- Start mobile onlydev:web- Start web only
Build
build- Build backend and webbuild:backend- Build backendbuild:web- Build webbuild:mobile- Build mobile
Testing
test- Run all teststest:backend- Test backendtest:mobile- Test mobiletest:watch- Watch mode for all tests
Linting
lint- Lint all projectslint:fix- Fix linting issues in all projects
Cleanup
clean- Clean build artifactsclean:all- Clean everything including node_modules
Database
prisma:generate- Generate Prisma clientprisma:migrate- Run database migrationsprisma:studio- Open Prisma Studio
🛠️ Scripts Directory
The scripts/ directory contains utility scripts:
install-all.sh- Install all dependenciesrun-dev.sh- Run all development serversadd-package.sh- Add package to a projectremove-package.sh- Remove package from a projectclean-all.sh- Clean all build artifacts
Make scripts executable:
chmod +x scripts/*.sh
📚 Project-Specific Documentation
🤝 Contributing
- Install dependencies:
npm run install:all - Start development:
npm run dev:all - Make your changes
- Run tests:
npm test - Run linter:
npm run lint:fix
📄 License
ISC