prime8dev

prime8dev
git clone https://git.prime8.dev/prime8dev.git
Log | Files | Refs | README | LICENSE

README.md (1012B)


      1 # prime8.dev backend
      2 
      3 Go + html/template backend for [prime8.dev](https://prime8.dev).
      4 
      5 ## Stack
      6 
      7 - Go
      8 - Chi
      9 - HTMX
     10 
     11 ## Development
     12 
     13 Run locally:
     14 
     15 ```sh
     16 go run ./cmd/tui
     17 go run ./cmd/buildjs
     18 go run ./cmd/server
     19 ```
     20 
     21 Or use `just` recipes:
     22 
     23 ```sh
     24 just web
     25 just ssh
     26 just tui
     27 ```
     28 
     29 Build Docker image:
     30 
     31 ```sh
     32 docker build -t prime8dev .
     33 ```
     34 
     35 ## Projects
     36 
     37 Project READMEs and commit dates are read from local bare git repos with
     38 `git` (no API). Project pages link to the [stagit](https://codemadness.org/stagit.html)
     39 site.
     40 
     41 | Env | Default | Purpose |
     42 | --- | --- | --- |
     43 | `GIT_REPOS_DIR` | `/srv/git/repos` | Bare repos live at `$GIT_REPOS_DIR/<repo>.git` |
     44 | `GIT_WEB_BASE` | `https://git.prime8.dev` | stagit base: `<base>/<repo>/`, `file/<path>.html`, `raw/<path>` |
     45 
     46 In Docker, bind-mount the repos read-only, e.g.
     47 `-v /srv/git/repos:/srv/git/repos:ro`. The image sets
     48 `safe.directory '*'` so repos owned by another uid are readable.
     49 
     50 ## Deploy
     51 
     52 Deploys are triggered by a `post-receive` hook on the bare repo.