gitlite

gitlite (glite) is a local Git server + web UI for everyday Git workflows.

Use it to manage commits, stash, push/pull, and diffs in your browser, without installing GitHub Desktop.

What You Get

• Status, changed files, and diffs
• Stage/unstage and discard flows
• Commit, stash/apply/drop stash
• Branch checkout, fetch, pull, push

Quick Start (No Install)

npx @alvix/gitlite /absolute/path/to/your/repo

Add To Any Project

Prerequisites:

• Node.js 20+
• Git on PATH

From your own repository:

cd /absolute/path/to/your/repo
npm i -D @alvix/gitlite

Add scripts in your package.json:

{
  "scripts": {
    "dev": "glite .",
    "git:ui:5050": "glite . --port 5050"
  }
}

Start the Git server + UI:

npm run dev

That gives you a local Git management UI for the current repo, so your team can avoid installing GitHub Desktop.

If your project already uses dev, keep it and add a dedicated script:

{
  "scripts": {
    "dev": "your-existing-dev-command",
    "git:ui": "glite ."
  }
}

Run:

npm run git:ui

CLI Usage

glite /absolute/path/to/your/repo
glite /absolute/path/to/your/repo --port 5050
glite /absolute/path/to/your/repo --config /absolute/path/to/config.json
glite /absolute/path/to/your/repo --detached
glite --help
glite --version

Theme Configuration

gitlite supports theme config from:

• Local file passed at startup: glite <repo-path> --config <config-path>
• Global file fallback:
  • macOS/Linux: ~/.config/gitlite/config.json
  • Windows: %APPDATA%\\gitlite\\config.json

Example:

{
  "theme": {
    "preset": "monokai",
    "ui": {
      "accentPrimary": "#ff8c00",
      "surface0": "#1f1f1f"
    },
    "monaco": {
      "preset": "monokai",
      "fontFamily": "Menlo, Monaco, Consolas, 'Courier New', monospace",
      "rules": [
        { "token": "comment", "foreground": "6A9955", "fontStyle": "italic" }
      ],
      "colors": {
        "editor.lineHighlightBackground": "#2A2D2E"
      }
    }
  }
}

Supported presets:

• vsdark (default)
• vslight
• monokai
• onedarkmodern

Development (This Repo)

pnpm install
pnpm dev

Build production standalone artifacts:

pnpm run build:all

Publishing steps are documented in /Users/nishkal/Desktop/github-repos/gitlite/publishing-guide.md.