Three user-facing "export my data" entry points (settings/privacy, settings/data, backup/export) all called endpoints that never existed on the backend: /v1/settings/data and /v1/compliance/export-data both 404. Every click silently failed or showed a fake "queued, check your email" message with nothing ever sent. A fully working, real GDPR export pipeline already exists at /api/v1/data-export (request -> async generate -> poll status -> download), just never wired to any UI. Added a shared requestAndDownloadDataExport flow (web/utils/dataExportFlow.ts) that requests the export, polls status until ready, then streams and downloads the file, and pointed all three pages plus userService's mismatched getExportStatus (was missing the required exportId path param) at it. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
🚀 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