Painless self-hosted all-in-one software development service, including Git hosting, code review, team collaboration, package registry and CI/CD
🚀 Quick Start • 📋 What's New • 📊 Current Status • 🛠️ Tech Stack • 📁 Architecture • 🤝 Contributing
Giteria is a comprehensive, self-hosted all-in-one software development platform that provides Git hosting, code review, team collaboration, package registry, and CI/CD capabilities. Built as a modern alternative to existing solutions, Giteria offers a seamless experience for development teams seeking full control over their infrastructure.
- 🚀 Modern Architecture - Go 1.21+ backend + TypeScript 5 frontend
- 📦 Complete Git Hosting - Full-featured Git server with SSH/HTTPS support
- 🔐 Complete Authentication System - JWT-based system with login/register forms and context
- ⚡ High-Performance Backend - Go-based server with GORM + PostgreSQL integration
- 🎨 Modern Frontend - Next.js 16 + React 19.2.1 + shadcn/ui component library
- 🏗️ Enterprise-Ready Design - Scalable, secure, and maintainable architecture
- 📚 Comprehensive Documentation - Complete docs and API references
- 🛠️ Developer-Friendly - Make commands, hot reload, TypeScript strict mode
- 📋 Issue Tracking - Full-featured issue management with labels, milestones
- 🔀 Pull Requests - Code review, merge requests, and collaboration
- 📦 Package Registry - Host your own packages (npm, Go, etc.)
- ⚙️ CI/CD - Integrated continuous integration and deployment pipelines
- ✅ Hybrid Monorepo Architecture - Go backend + TypeScript frontend workspaces
- ✅ Complete Authentication System - JWT with login/register forms and React context
- ✅ Go Backend Server - High-performance Gin API with GORM + PostgreSQL
- ✅ Next.js 16 Frontend - Modern React 19.2.1 with shadcn/ui + Tailwind CSS v4
- ✅ Issue Tracking System - Full issue management with labels, milestones, and assignees
- ✅ Pull Request/Merge Requests - Code review, inline comments, and approvals
- ✅ Repository Management - Create, fork, and manage repositories
- ✅ Access Control - Organization and team permissions
- ✅ Wiki System - Documentation and knowledge base for each repository
- ✅ Activity Feed - Track all project activities and notifications
- ✅ SSH Key Management - Secure Git access with deploy keys
- ✅ Webhooks - Integration with external services
- ✅ Package Registry - Host npm, Go, and other package types
- ✅ CI/CD Pipelines - Integrated continuous integration
- ✅ Container Registry - Docker container hosting (Future)
✅ In Development: Building a comprehensive self-hosted Git platform with modern architecture.
- ✅ Hybrid Monorepo Architecture - Go backend + TypeScript frontend workspaces
- ✅ Complete Authentication System - JWT with login/register forms and React context
- ✅ Go Backend Server - High-performance Gin API with GORM + PostgreSQL
- ✅ Next.js 16 Frontend - Modern React 19.2.1 with shadcn/ui + Tailwind CSS v4
- ✅ Database Layer - GORM with PostgreSQL and comprehensive data models
- ✅ Git Operations - Git service layer with proper handling
- ✅ Repository Creation - Create and manage Git repositories
- ✅ Repository Browsing - File browser with syntax highlighting
- ✅ Branch Management - Create, delete, and manage branches
- ✅ Tag Management - Release tagging support
- ✅ Issue System - Create, track, and manage issues
- ✅ Issue Labels - Categorize issues with labels
- ✅ Milestones - Track progress with milestones
- ✅ Comments - Discussion and comments on issues/PRs
- ✅ Development Environment - Hot reload, TypeScript strict mode, Go modules
- ✅ Docker Deployment - Production-ready containers
- ✅ Security Implementation - Rate limiting, validation, security headers
- ✅ Structured Logging - Pino-based logging with correlation
- Pull Request System - Code review and merge requests
- Organization Management - Teams and organization settings
- Wiki System - Repository documentation
- Activity Stream - User and repository activities
- API Documentation - Comprehensive API documentation and testing
- Package Registry - npm, Go, Maven repositories
- CI/CD System - Integrated pipelines
- Container Registry - Docker image hosting
- Advanced Security - 2FA, SSO, LDAP integration
- Migration Tools - Import from GitHub, GitLab, Gitea
- Go 1.21.0 or higher (for backend)
- Node.js 18.0.0 or higher (for frontend)
- pnpm 9.0.0 or higher (recommended package manager)
- PostgreSQL 14.0 or higher (for database)
- Docker (optional, for container deployment)
- Make (for command shortcuts - included with most systems)
-
Clone the repository
git clone https://github.com/skygenesisenterprise/giteria.git cd giteria -
Quick start (recommended)
# One-command setup and start make quick-start -
Manual setup
# Install Go dependencies cd server && go mod download && cd .. # Install Node.js dependencies make install # Environment setup make env-dev # Database initialization make db-migrate # Start development servers make dev
Once running, you can access:
- Frontend: http://localhost:3001
- API Server: http://localhost:8080
- Health Check: http://localhost:8080/health
# 🚀 Quick Start & Development
make quick-start # Install, migrate, and start dev servers
make dev # Start all services (frontend + backend)
make dev-frontend # Frontend only (port 3001)
make dev-backend # Backend only (port 8080)
# 🏗️ Building & Production
make build # Build all packages
make start # Start production servers
# 🗄️ Database
make db-studio # Open Prisma Studio
make db-migrate # Run migrations
make db-seed # Seed development data
# 🔧 Code Quality & Testing
make lint # Lint all packages
make typecheck # Type check all packages
make format # Format code with Prettier
# 🛠️ Utilities
make help # Show all available commands
make status # Show project status
make health # Check service health💡 Tip: Run
make helpto see all available commands organized by category.
Next.js 16 + React 19.2.1 + TypeScript 5
├── 🎨 Tailwind CSS v4 + shadcn/ui (Styling & Components)
├── 🔐 JWT Authentication (Complete Implementation)
├── 🛣️ Next.js App Router (Routing)
├── 📝 TypeScript Strict Mode (Type Safety)
├── 🔄 React Context (State Management)
└── 🔧 ESLint + Prettier (Code Quality)
Go 1.21+ + Gin Framework
├── 🗄️ GORM + PostgreSQL (Database Layer)
├── 🔐 JWT Authentication (Complete Implementation)
├── 🛡️ Middleware (Security, CORS, Logging)
├── 🌐 HTTP Router (Gin Router)
├── 📦 JSON Serialization (Native Go)
└── 📊 Structured Logging (Zerolog/Pino)
PostgreSQL + GORM
├── 🏗️ Schema Management (Auto-migration)
├── 🔍 Query Builder (Type-Safe Queries)
├── 🔄 Connection Pooling (Performance)
├── 👤 User Models (Complete Implementation)
├── 📚 Repository Models
├── 📝 Issue & PR Models
└── 📈 Seed Scripts (Development Data)
Make + pnpm Workspaces + Go Modules
├── 📦 app/ (Next.js Frontend - TypeScript)
├── ⚙️ server/ (Gin API - Go)
├── 🛠️ tools/ (Development Utilities - TypeScript)
├── 📚 services/ (Core Services - Go)
├── 🗂️ routers/ (API Routing - Go)
├── 📦 models/ (Data Models - Go)
└── 🐳 docker/ (Container Configuration)
giteria/
├── app/ # Next.js 16 Frontend Application (TypeScript)
│ ├── components/ # React components with shadcn/ui
│ │ ├── ui/ # UI component library
│ │ └── ...
│ ├── context/ # React contexts
│ │ └── AuthContext.tsx # Authentication state
│ ├── lib/ # Utility functions
│ ├── styles/ # Tailwind CSS styling
│ └── ...
├── server/ # Go Backend Server
│ ├── cmd/
│ │ └── server/
│ │ └── main.go # CLI entry point
│ ├── src/
│ │ ├── config/ # Database and server configuration
│ │ ├── controllers/ # HTTP request handlers
│ │ ├── middleware/ # Gin middleware (auth, validation)
│ │ ├── models/ # Data models and structs
│ │ ├── routes/ # API route definitions
│ │ ├── services/ # Business logic
│ │ └── tests/ # Unit and integration tests
│ ├── main.go # Main server entry point
│ ├── go.mod # Go modules file
│ └── go.sum # Go modules checksum
├── models/ # Core Data Models (Go)
│ ├── user/ # User models
│ ├── repo/ # Repository models
│ ├── issues/ # Issue tracking models
│ ├── pull/ # Pull request models
│ └── ...
├── services/ # Core Services (Go)
│ ├── auth/ # Authentication service
│ ├── git/ # Git operations service
│ ├── repo/ # Repository management
│ └── ...
├── modules/ # Reusable Modules (Go)
├── routers/ # API Routing (Go)
│ ├── api/ # API v1 routes
│ ├── web/ # Web UI routes
│ └── ...
├── prisma/ # Database Schema & Migrations
│ ├── schema.prisma # Database schema definition
│ └── ...
├── docker/ # Docker Configuration
├── docs/ # Documentation
└── ...
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Next.js App │ │ Gin API │ │ PostgreSQL │
│ (Frontend) │◄──►│ (Backend) │◄──►│ (Database) │
│ Port 3001 │ │ Port 8080 │ │ Port 5432 │
│ TypeScript │ │ Go │ │ │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
JWT Tokens API Endpoints User/Repo/Issue Data
React Context Authentication GORM ORM
shadcn/ui Components Business Logic Auto-migrations
# New developer setup
make quick-start
# Daily development
make dev # Start working (Go + TypeScript)
make lint-fix # Fix code issues
make typecheck # Verify types
make test # Run tests
# Go-specific development
cd server
go run main.go # Start Go server
go test ./... # Run Go tests
go fmt ./... # Format Go code
go mod tidy # Clean dependencies
# TypeScript-specific development
make dev-frontend # Frontend only
make lint # Check code quality
make typecheck # Verify types
# Before committing
make format # Format code
make lint # Check code quality
make typecheck # Verify types
# Database changes
make db-migrate # Apply migrations
make db-studio # Browse database
# Production deployment
make build # Build everything
make docker-build # Create Docker image
make docker-run # Deploy- Make-First Workflow - Use
makecommands for all operations - Go Best Practices - Follow Go conventions for backend code
- TypeScript Strict Mode - All frontend code must pass strict type checking
- Conventional Commits - Use standardized commit messages
- Component Structure - Follow established patterns for React components
- API Design - RESTful endpoints with proper HTTP methods
- Error Handling - Comprehensive error handling and logging
- Security First - Validate all inputs and implement proper authentication
The authentication system is fully implemented with Go backend and TypeScript frontend:
- JWT Tokens - Secure token-based authentication with refresh mechanism
- Login/Register Forms - Complete user authentication flow with validation
- Auth Context - Global authentication state management in React
- Protected Routes - Route-based authentication guards
- Go API Endpoints - Complete authentication API with Gin framework
- Password Security - bcrypt hashing for secure password storage
- Session Management - LocalStorage-based session persistence
We're looking for contributors to help build this comprehensive self-hosted Git platform! Whether you're experienced with Go, TypeScript, web development, or DevOps, there's a place for you.
- Fork the repository and create a feature branch
- Check the issues for tasks that need help
- Join discussions about architecture and features
- Start small - Documentation, tests, or minor features
- Follow our code standards and commit guidelines
- Go Backend Development - API endpoints, business logic, Git operations
- TypeScript Frontend Development - React components, UI/UX design
- Database Design - Schema development, migrations, optimization
- DevOps Engineers - Docker, deployment, CI/CD
- Security Specialists - Authentication, encryption
- Documentation - API docs, user guides, tutorials
- 📖 Documentation - Comprehensive guides and API docs
- 🐛 GitHub Issues - Bug reports and feature requests
- 💡 GitHub Discussions - General questions and ideas
- 📧 Email - developer@skygenesisenterprise.com
When reporting bugs, please include:
- Clear description of the problem
- Steps to reproduce
- Environment information (Go version, Node.js version, OS, etc.)
- Error logs or screenshots
- Expected vs actual behavior
| Component | Status | Technology | Notes |
|---|---|---|---|
| Hybrid Architecture | ✅ Working | Go + TypeScript | Monorepo design |
| Authentication System | ✅ Working | JWT (Go/TS) | Full implementation with forms |
| Go Backend API | ✅ Working | Gin + GORM | High-performance with PostgreSQL |
| Frontend Framework | ✅ Working | Next.js 16 + React 19.2.1 | shadcn/ui + Tailwind CSS v4 |
| Repository Management | ✅ Working | Go/TS | Create, browse, manage repos |
| Issue Tracking | ✅ Working | Go/TS | Full issue system with labels |
| UI Component Library | ✅ Working | shadcn/ui + Tailwind CSS | Complete component set |
| Database Layer | ✅ Working | GORM + PostgreSQL | Auto-migrations + models |
| Docker Deployment | ✅ Working | Multi-Stage | Containerized deployment |
| Pull Requests | 🔄 In Progress | Go/TS | Code review system |
| Organization Mgmt | 🔄 In Progress | Go/TS | Teams and org settings |
| Wiki System | 📋 Planned | Go/TS | Repository documentation |
| Package Registry | 📋 Planned | Go/TS | npm, Go, Maven repos |
| CI/CD | 📋 Planned | Go/TS | Integrated pipelines |
Development led by Sky Genesis Enterprise
We're looking for sponsors and partners to help accelerate development of this open-source Git hosting platform.
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2025 Sky Genesis Enterprise
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
- Sky Genesis Enterprise - Project leadership and development
- Go Community - High-performance programming language and ecosystem
- Gin Framework - Lightweight HTTP web framework
- GORM Team - Modern Go database library
- Next.js Team - Excellent React framework
- React Team - Modern UI library
- shadcn/ui - Beautiful component library
- pnpm - Fast, disk space efficient package manager
- Make - Universal build automation and command interface
- Docker Team - Container platform and tools
- Open Source Community - Tools, libraries, and inspiration
⭐ Star This Repo • 🐛 Report Issues • 💡 Start a Discussion
🔧 Building the next generation of self-hosted software development platform
Made with ❤️ by the Sky Genesis Enterprise team
