Something went wrong. Try again.
Tea journaling on ATProto (alpha) forked from arabica.social/arabica
Something went wrong. Try again.
Files
Verified signature Signed by pdewey.com SHA256:ePOVkJstqVLchGK8m9/OGQG+aFNHD5XN3xjvW9wKCA4 Click to copy SHA
Verified signature Signed by pdewey.com SHA256:ePOVkJstqVLchGK8m9/OGQG+aFNHD5XN3xjvW9wKCA4 Click to copy SHA
Verified signature Signed by pdewey.com SHA256:ePOVkJstqVLchGK8m9/OGQG+aFNHD5XN3xjvW9wKCA4 Click to copy SHA
- Go 81%
- CSS 9%
- JavaScript 8%
- Nix 2%
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…