🐾 Tigler — Lightweight Git Web Interface

Tigler is a minimalist, forensic-friendly Git web interface built for clarity, auditability, and modular integration. It supports browsing, settings management, and repository creation with LDAP-backed authentication.

---

🚀 Features

• 🔍 Browse Git repositories via default branch or specific refs

• 🛠 Edit repository metadata (.meta) with ACLs and descriptions

• 🔐 LDAP-based login/logout with session tracking

• 🧠 Context-aware routing (user, repo, branch, subpath)

• 📁 Bare repo creation with normalized naming and metadata

• 🧾 XML-based .meta format for permissions and audit trails

• 🎨 Clean UI with CSS-driven state transitions and error overlays

---

📦 Structure

tigler/
├── src/main/java
│   └── GitDetectFilter.java # Routes Git clients to GitServlet, others to TigServlet 
│   └── GitServlet.java # handle git commands
│   └── TigServlet.java # Handles UI, repo browsing, settings, creation 
│   └── RepoMeta.java # Record for .meta structure 
│
└── src/main/webapp
    ├── WEB-INF/ 
    └── web.xml # Servlet/filter mappings 
    └── jsp/views
	     └── 	overview.jsp
	     └── userRepos.jsp
	     └── repoView.jsp
	     └── settings.jsp

---

⚙️ Configuration

Set the following environment variables:

git.repoBase     = /path/to/the/repos
git.ldapUrl      = ldap://localhost:389
git.userBaseDn   = ou=people,dc=serveronline,dc=org

---

🧪 Development Notes

All routing is context-aware (/git/user/repo)

.meta files are parsed into RepoMeta records

Use RepoMeta.fromRequest(req) and writeMeta(file, meta) for consistency

Git clients are detected via User-Agent and path heuristics

UI actions (createRepo, updateSettings) are handled in TigServlet.doPost()

---

🔒 Permissions Model

<git public="true">
  <description>...</description>
  <branch>main</branch>
  <permissions>
    <admins><member>alice</member></admins>
    <readers><member>bob</member></readers>
    <writers><member>carol</member></writers>
  </permissions>
</git>

---

📜 License

MIT — see LICENSE.txt.

---

📬 Contact

For questions or contributions: stefan [at] franke [dot] ms