gitrepublic-web/docs/about.md

About GitRepublic

GitRepublic is a decentralized git hosting platform built on Nostr. Unlike traditional git hosting services, GitRepublic provides truly decentralized repository hosting where repositories are announced on Nostr relays, giving you full control and ownership.

Key Features

• Decentralized: Repositories are announced on Nostr relays, no central authority
• Nostr-based Authentication: Uses NIP-07 (browser extensions) and NIP-98 (HTTP authentication)
• Full Control: Own your repositories, transfer ownership, manage maintainers, control access
• Open Collaboration: Create pull requests, issues, and collaborate using Nostr events
• Multi-remote Sync: Automatically syncs to multiple remotes when you push
• GRASP Compatible: Works seamlessly with GRASP servers

Documentation Topics

Core Concepts

• How this git server integrates Nostr - Understanding the Nostr-based architecture

Repository Operations

• Creating, forking, transferring, or cloning a repo - Getting started with repositories

• Editing a repo - Branch management, file management, auto-provisioning, file-editing and event-creation permissions

• Managing a repo - Complete guide to repository management

  • Repo Header
  • Clone Section
  • File Tab
  • Commit Tab
  • PRs Tab
  • Issues Tab
  • Patches Tab
  • Discussions Tab
  • Docs Tab
  • History Tab
  • Tags Tab

Discovery and Access

• Search and viewing external git repos - Finding and viewing repositories

API and CLI

• REST API and CLI - Programmatic access and command-line tools

User Features

• Profile pages - User profiles and payment targets

• Settings and Dashboard - User account management

Infrastructure

• Working with GRASP servers - GRASP protocol compatibility

• Lightweight versus Enterprise modes - Deployment options and security

Technical Details

• Tech stack used - Code editor, syntax highlighter, programming languages, logger, etc.

• Specs used - Links to NIPs and GRASP docs, and list of custom events

Getting Started

1. Install a NIP-07 browser extension (Alby, nos2x, etc.)
2. Visit a GitRepublic instance and connect with your extension
3. Create your first repository via the signup page
4. Start collaborating using pull requests, issues, and patches

For detailed instructions, see the topic pages above.

Additional Resources

• API Documentation - OpenAPI specification