sourcelo

The sourcelo Project

Overview

sourcelo is a minimal, GitLab‑compatible forge built for clarity, speed, and long‑term maintainability.
It is designed for operators who prefer simple systems, predictable behavior, and a clean UNIX‑native architecture.
The interface is intentionally quiet: no ads, no clutter, no distractions.

Features

• GitLab API compatibility
• Lightweight system‑UI based frontend
• Minimal SCSS design system
• Fast repository browsing
• Clean merge request workflow
• Straightforward issue tracking
• Predictable, keyboard‑friendly navigation
• Prometheus metrics endpoint

Requirements

• Ruby
• Prometheus (optional)
• Git (git, libgit2)
• PostgreSQL
• Valkey or Redis
• Node.js (for Dart Sass)
• A supported OS

Installation

git clone https://gitlab.com/srclo/srclo.git $HOME/repos/srclo
cd $HOME/repos/srclo
bundle install
rake setup && rake migrate
rake init

Development

Hot reload is enabled for both backend and frontend components.
The codebase is intentionally small and easy to navigate.

Directory Structure

All Community Edition (CE) source code lives under src/ce/rb/.
Enterprise Edition (EE) extensions load separately and never modify CE directly.

src/ce/rb/
├── app.rb            ; main application entrypoint
├── config.rb         ; application settings and environment loading
├── config.ru         ; Rack configuration
├── db/               ; migrations and schema files
├── init.sh           ; initialization helper script
├── lib/              ; internal libraries and helpers
├── Makefile          ; build and task automation
├── prometheus.yml    ; metrics configuration
├── public/           ; static assets
├── puma.rb           ; Puma server configuration
├── styles/           ; SCSS and UI assets
└── views/            ; templates

Philosophy

• Minimal UI
• No dark patterns
• No unnecessary features
• Everything readable in a terminal
• Tools should stay out of the way
• Built with sh + Ruby, nothing more

Supported OSes

sourcelo is portable and runs on a wide range of UNIX‑like systems:

• FreeBSD
• NetBSD
• OpenBSD
• OmniOS
• OpenIndiana
• Tribblix
• Ubuntu LTS GNU/Linux
• Debian GNU/Linux
• RHEL
• Fedora
• SLES
• openSUSE Leap
• openSUSE Tumbleweed
• Arch GNU/Linux
• Artix Linux
• Alpine Linux
• Gentoo

License

sourcelo is released under the 3‑Clause BSD license.

• Community Edition (CE): BSD 3‑Clause
• Enterprise Edition (EE): Server Side Public License (SSPL)

Using only CE keeps the entire deployment under 3BSD.
Enabling EE components brings SSPL terms into effect.