4.4 KiB

Raw Blame History

Tech Stack Used

Technical implementation details of GitRepublic, including programming languages, frameworks, libraries, and tools.

Frontend

Framework

SvelteKit: Full-stack framework with SSR support
TypeScript: Type-safe JavaScript
Svelte 5: Reactive UI framework

Code Editor

CodeMirror 6: Full-featured code editor
- @codemirror/autocomplete: Code autocompletion
- @codemirror/basic-setup: Basic editor setup
- @codemirror/commands: Editor commands
- @codemirror/lang-markdown: Markdown language support
- @codemirror/language: Language support infrastructure
- @codemirror/search: Search and replace functionality
- @codemirror/state: Editor state management
- @codemirror/view: Editor view components

Syntax Highlighting

highlight.js: Syntax highlighting for code blocks
CodeMirror language modes: Language-specific highlighting in editor

Markdown Processing

markdown-it: Markdown parser and renderer
asciidoctor: AsciiDoc support (via codemirror-asciidoc)

UI Components

Custom Svelte components for:
- Repository browser
- Code editor
- Pull request detail view
- Issue management
- File tree navigation

Backend

Runtime

Node.js: JavaScript runtime
SvelteKit: Server-side rendering and API routes

Git Operations

git-http-backend: Git smart HTTP protocol handler
simple-git: Node.js git wrapper for repository operations

Web Server

SvelteKit adapter-node: Node.js adapter for production
Vite: Build tool and dev server

Nostr Integration

Nostr Libraries

nostr-tools: Core Nostr functionality
- Event creation and signing
- NIP-19 encoding/decoding (npub, nsec, naddr, etc.)
- Event verification
- Relay communication utilities

WebSocket Client

ws: WebSocket client for Nostr relay connections
Custom NostrClient: WebSocket client wrapper for relay operations

Authentication

NIP-07: Browser extension integration (client-side)
NIP-98: HTTP authentication implementation (server-side)

Logging

Logger

pino: Fast, structured JSON logger
pino-pretty: Human-readable log formatting for development

Logging Features

Structured logging with context
Log levels (debug, info, warn, error)
Audit logging for security events
Performance logging

Logging is configured via environment variables and uses structured JSON logging with pino.

Networking

Tor Support

socks: SOCKS proxy support for Tor connections
Tor .onion address support for repositories
Tor routing for Nostr relay connections

Email

nodemailer: Email sending for notifications (optional)

Development Tools

Type Checking

TypeScript: Static type checking
svelte-check: Svelte-specific type checking

Linting and Formatting

ESLint: JavaScript/TypeScript linting
Prettier: Code formatting
@typescript-eslint: TypeScript-specific ESLint rules

Build Tools

Vite: Fast build tool and dev server
TypeScript Compiler: Type checking and compilation

Programming Languages

TypeScript: Primary language for all code
JavaScript: Runtime language (compiled from TypeScript)
Svelte: Component framework (compiled to JavaScript)

Database/Storage

File System: Git repositories stored on filesystem
JSONL Files: Event storage in nostr/repo-events.jsonl format
No SQL Database: Uses filesystem and Nostr relays for data storage

Security

Authentication Libraries

nostr-tools: Cryptographic signing and verification
Custom NIP-98 implementation for HTTP authentication

Security Features

Path validation
Input sanitization
Rate limiting
Audit logging
Process isolation (git-http-backend)

Deployment

Containerization

Docker: Container support
Docker Compose: Multi-container orchestration
Kubernetes: Enterprise mode deployment (optional)

Adapters

@sveltejs/adapter-node: Node.js production adapter

CLI Tools

The CLI (gitrepublic-cli) uses:

nostr-tools: Nostr event handling
Node.js: Runtime environment
Native git: Git operations via git commands

Version Requirements

Node.js: 18+ (for both web app and CLI)
Git: Required for git operations
npm: Package management

Next Steps

Specs used - NIPs and GRASP documentation