Tea journaling on ATProto (alpha) forked from arabica.social/arabica
Files
README.md
# Arabica Coffee brew logging application built on ATProto Development is on Tangled, and is mirrored to GitHub: - [Tangled](https://tangled.org/arabica.social/arabica) - [GitHub](https://github.com/arabica-social/arabica) ## Quick Start ```bash # Using Nix nix run # Or with Go templ generate go run ./cmd/arabica ``` Access at http://127.0.0.1:18910 (arabica) or http://127.0.0.1:18920 (oolong) ## Configuration ### Command-Line Flags - `--known-dids <file>` - Path to file with DIDs to backfill on startup (one per line) ### Environment Variables - `PORT` - Server port (default: 18910) - `SERVER_PUBLIC_URL` - Public URL for reverse proxy deployments (e.g., https://arabica.example.com) - `ARABICA_DB_PATH` - OAuth session database path. Defaults to <XDG_DATA_HOME or ~/.local/share>/arabica/arabica.db. Only needed to override the default location. - `ARABICA_PROFILE_CACHE_TTL` - Profile cache duration (default: 1h) - `OAUTH_CLIENT_ID` - OAuth client ID (optional, uses loopback mode if not set) - `OAUTH_REDIRECT_URI` - OAuth redirect URI (optional) - `SECURE_COOKIES` - Set to true for HTTPS (default: false) - `LOG_LEVEL` - Logging level: debug, info, warn, error (default: info) - `LOG_FORMAT` - Log format: console, json (default: console) ## Development ### Prerequisites - [Go](https://go.dev/) 1.26+ - [Templ](https://templ.guide/): `go install github.com/a-h/templ/cmd/templ@latest` - [just](https://github.com/casey/just) (optional but recommended); run helpers in `justfile` ### Setup 1. Create `roles.json` with moderator roles. Env var: `ARABICA_MODERATORS_CONFIG=roles.json` 2. (Optional) Create `known-dids.txt` with one DID per line. Flag: `-known-dids known-dids.txt` ### Running With Nix: ```bash nix develop templ generate go run ./cmd/arabica ``` Without Nix, there are run helpers in `justfile`: ```sh just run # dev server: debug logging, hot reload, moderator config just test # run tests (regenerates templ first) just templ-watch # run with live template reg…