From 41178f6bad1f2e1eaed462475cb7aa26185dc0ac Mon Sep 17 00:00:00 2001
From: Marc Pervaz Boocha <mboocha@sudomsg.com>
Date: Sun, 27 Jul 2025 15:43:06 +0530
Subject: Initial Commit

---
 README.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..16f4b75
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# GOPKGSERVER
+
+A minimal Go server for serving vanity URLs, configurable via TOML.
+
+## Status
+
+**Alpha** — functional but rough. No tests yet. Interface and config format may change.
+
+## Features
+
+- Serves vanity URLs for `go get`
+- Configurable with TOML
+- Supports VCS repositories (e.g., git)
+- Custom directory and file view URLs
+
+## Usage
+
+```bash
+gopkgserver -config /path/to/config.toml
+```
+
+## Configuration
+
+Configuration is passed via the -config flag as a TOML file. Example structure:
+
+``` toml
+[server]
+address = ":6000"
+
+[repo."go.example.com/cache"]
+repo = "https://git.example.com/mirror/cache.git"
+vcs = "git"
+home = "-"
+directory = "https://git.example.com/mirror/cache.git/tree/{/dir}"
+file = "https://git.example.com/cache/mirror/cache.git/tree/{/dir}/{file}#n{line}"
+```
+
-- 
cgit v1.2.3-70-g09d2