A modern GitHub-like git hosting platform built with TypeScript, Bun, React, and more.
Sigmagit is a fully-featured git hosting platform that allows you to host and manage your code with ease.
- Bun 1.3+: JavaScript runtime and package manager
- Node.js 20+: For certain dependencies
- PostgreSQL 14+: Database
- Redis (optional): For caching
- S3-compatible storage or local filesystem: For git objects
# Clone repository
git clone <repository-url>
cd sigmagit
# Install dependencies
bun install
# Set up environment
cp .env.example .env
# Edit .env with your configuration
# Run database migrations
bun run db:push
# Start web app + API server
bun run dev:web
# Start mobile app + API server (optional)
bun run dev:mobile
# Start Discord bot only (optional)
bun run dev:discordsigmagitv2/
├── apps/
│ ├── api/ # Hono API server (Bun)
│ ├── web/ # TanStack Start web application
│ ├── mobile/ # Expo React Native mobile app
│ ├── docs-vitepress/ # VitePress documentation site
│ ├── discord-bot/ # Discord integration bot
│ └── runner/ # Go-based CI runner agent
├── packages/
│ ├── db/ # Drizzle ORM schema + migrations
│ ├── lib/ # Shared utilities + API client
│ └── hooks/ # Shared React Query hooks/types
├── docs/ # Markdown technical docs
├── turbo.json # Turbo monorepo pipeline config
└── .env.example # Environment variables template
- Quick Start - This file
- API Documentation - API endpoints and usage
- Web App - Web app development
- Mobile App - Mobile app development
- Discord Bot - Discord integration
- Architecture - System architecture
- Development - Development workflow
- Deployment - Deployment guides
- Features - Feature documentation
- Security - Security best practices
- Git Operations - Git hosting features
- Authentication - User authentication
- Storage - Git object storage
- Webhooks - Webhook notifications
- Account Linking - Discord account linking
- Container Registry - OCI/Docker image hosting
Sigmagit includes an OCI Distribution (Docker Registry) v2–compatible API for hosting container images. Use your API host as the registry:
docker login <API_HOST> # username + password or username + API key
docker push <API_HOST>/<owner>/<image>:<tag>
docker pull <API_HOST>/<owner>/<image>:<tag>Images are stored in the same S3 or local storage backend as git objects, under the registry/ prefix. Access follows Sigmagit identities: push/pull is allowed for the namespace owner (user or org) and org members.
- Runtime: Bun 1.3.5+
- Language: TypeScript
- Frontend: React 19, TanStack Start, TailwindCSS
- Backend: Hono, Bun
- Mobile: React Native, Expo
- Database: PostgreSQL, Drizzle ORM
- Caching: Redis (optional)
- Storage: S3-compatible or local filesystem
- Authentication: better-auth
- UI: shadcn/ui, lucide-react, tanstack-theme-kit
- State Management: TanStack Query, TanStack Store
- Forms: react-hook-form
- Routing: TanStack Router (file-based)
- Git: isomorphic-git
- Email: Resend or Nodemailer (SMTP)
- Database: Drizzle ORM, postgres
See Environment Variables section below) for required configuration.
- Redis: Enable for caching and rate limiting
- S3: Configure for git object storage (alternatively use local)
- SMTP: Configure for email sending (alternatively use Resend)
The API server provides REST endpoints for all Sigmagit functionality.
- Base URL:
http://localhost:3001(configurable) - Documentation: API Documentation
Modern React-based web application with file-based routing.
- Base URL:
http://localhost:3000(configurable) - Documentation: Web App
React Native mobile application built with Expo.
- Documentation: Mobile App
Discord integration for notifications and repository management.
- Documentation: Discord Bot
- Feature Details: Account Linking
System architecture and data flow.
- Documentation: Architecture
Development setup, workflow, and best practices.
- Documentation: Development
Production deployment guides for various platforms.
- Documentation: Deployment
Detailed feature documentation.
Security best practices and guidelines.
- Documentation: Security
DATABASE_URL="postgresql://user:password@localhost:5432/sigmagit"
BETTER_AUTH_SECRET="your-super-secret-key-here"# Storage
STORAGE_TYPE="s3" # Options: s3, local
S3_ENDPOINT="https://your-s3-endpoint.com"
S3_REGION="auto"
S3_ACCESS_KEY_ID="your-access-key-id"
S3_SECRET_ACCESS_KEY="your-secret-access-key"
S3_BUCKET_NAME="your-bucket-name"
STORAGE_LOCAL_PATH="./data/repos" # Only if STORAGE_TYPE=local
# Redis (recommended)
REDIS_URL="redis://localhost:6379"
# Email
EMAIL_PROVIDER="resend" # Options: resend, smtp
RESEND_API_KEY="resend-api-key-here"
SMTP_HOST="smtp.example.com"
SMTP_PORT="587"
SMTP_SECURE="false"
SMTP_USER="your-username"
SMTP_PASS="your-password"
EMAIL_FROM="Sigmagit <noreply@sigmagit.dev>"
# API
API_URL="http://localhost:3001"
WEB_URL="http://localhost:3000"
# Discord Bot
DISCORD_BOT_TOKEN="your-bot-token-here"
DISCORD_CLIENT_ID="your-client-id-here"
DISCORD_GUILD_ID="your-server-id-here"
# Discord Webhooks (for API to send notifications to Discord)
DISCORD_WEBHOOK_URL="https://your-discord-webhook-url.com"
WEBHOOK_SECRET="your-webhook-secret-here"
PUBLIC_WEBHOOK_URL="http://your-domain.com/api/webhooks/discord"We welcome contributions! Please read our Contributing Guide for details.
License - See LICENSE file for details.
For support, please open an issue on GitHub Issues.
Made with ❤️ using Bun, TypeScript, React and TanStack