This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
caelum0x bab51cd428 test(backend): exclude e2e suite from default jest run
The default jest.config.js matched tests/e2e/*.e2e.test.ts, which are meant to
run only under jest.e2e.config.js against a real Postgres + Redis (npm run
test:e2e). Running them under the default (mocked) config made the parallel
suite non-deterministic: posts.e2e and snippets.e2e collided on shared DB state
and intermittently failed, while passing in isolation/serial.

Add testPathIgnorePatterns for tests/e2e so the default unit/integration run is
deterministic and needs no Docker datastores. The e2e suite still runs via its
own config. Default suite now green in parallel (57 suites / 1434 tests).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-06 12:13:32 +03:00
..

🚀 Gitgram

Instagram-like social platform for developers - Share projects, connect through code, and build your developer network.

Status Progress Phases License

🎉 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

Notes:

  • The backend port is controlled by PORT. In the monorepo docker-compose.yml it's set to 4000.
  • The frontend port is controlled by Next.js (3000 by 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


🧪 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

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. 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


🎯 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 projects
  • install:backend - Install backend dependencies
  • install:mobile - Install mobile dependencies
  • install:web - Install web dependencies

Development

  • dev - Start backend and web (parallel)
  • dev:all - Start all projects (parallel)
  • dev:backend - Start backend only
  • dev:mobile - Start mobile only
  • dev:web - Start web only

Build

  • build - Build backend and web
  • build:backend - Build backend
  • build:web - Build web
  • build:mobile - Build mobile

Testing

  • test - Run all tests
  • test:backend - Test backend
  • test:mobile - Test mobile
  • test:watch - Watch mode for all tests

Linting

  • lint - Lint all projects
  • lint:fix - Fix linting issues in all projects

Cleanup

  • clean - Clean build artifacts
  • clean:all - Clean everything including node_modules

Database

  • prisma:generate - Generate Prisma client
  • prisma:migrate - Run database migrations
  • prisma:studio - Open Prisma Studio

🛠️ Scripts Directory

The scripts/ directory contains utility scripts:

  • install-all.sh - Install all dependencies
  • run-dev.sh - Run all development servers
  • add-package.sh - Add package to a project
  • remove-package.sh - Remove package from a project
  • clean-all.sh - Clean all build artifacts

Make scripts executable:

chmod +x scripts/*.sh

📚 Project-Specific Documentation

🤝 Contributing

  1. Install dependencies: npm run install:all
  2. Start development: npm run dev:all
  3. Make your changes
  4. Run tests: npm test
  5. Run linter: npm run lint:fix

📄 License

ISC

gitgram