# 🐾 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:

```properties
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

```xml
<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