An event companion and onboarding experience for the ATmosphere (alpha)
atmo.quest
Add .env.example and update readme
authored by
Brittany Ellich
and committed by
Tangled
(May 16, 2026, 2:27 AM UTC)
404a2944
f040a3ac
+36
-4
+29
.env.example
+29
.env.example
···
1
+
# Copy to .env and adjust as needed. .env is gitignored — keep secrets here only.
2
+
3
+
# --- Required-ish for local dev ---
4
+
5
+
# Port the HTTP server binds to. Default 8080, but VS Code Helper squats on
6
+
# 8080/8090 on some macOS installs, so we use 9090 locally. Pick any free port.
7
+
PORT=9090
8
+
9
+
# Externally-visible origin of this server. Must match what you type in the
10
+
# browser AND what atproto OAuth uses to build the redirect URI. Use
11
+
# 127.0.0.1 (not localhost) for loopback dev — atproto is strict about this.
12
+
PUBLIC_URL=http://127.0.0.1:9090
13
+
14
+
# --- Optional ---
15
+
16
+
# DEBUG | INFO | WARN | ERROR. Default INFO. DEBUG is useful when triaging
17
+
# OAuth flows (indigo logs the full PAR / token requests at Debug).
18
+
# LOG_LEVEL=DEBUG
19
+
20
+
# SQLite DSN. Default is fine; override if you want a different file.
21
+
# DATABASE_URL=file:data/atmoquest.db?_pragma=journal_mode(WAL)&_pragma=foreign_keys(ON)
22
+
23
+
# --- Production only ---
24
+
#
25
+
# Both are auto-generated in dev (random session key per process, on-disk
26
+
# admin key at data/admin_signing.key). In prod they MUST be set.
27
+
#
28
+
# SESSION_SECRET=$(openssl rand -hex 32)
29
+
# ADMIN_SIGNING_KEY=$(openssl rand -base64 32)
+2
.gitignore
+2
.gitignore
+5
-4
README.md
+5
-4
README.md
···
5
5
## Quick start
6
6
7
7
```bash
8
-
task live
8
+
cp .env.example .env
9
+
go tool task live
9
10
```
10
11
11
-
Then open **<http://127.0.0.1:8080>**. The `task live` recipe runs templ-watch, the web-asset bundler, and an air-driven live-reloading Go server. If you don't have it: `brew install go-task` — or just `go run -tags dev ./cmd/web` for a one-shot.
12
+
Then open the URL printed in the logs (defaults to **<http://127.0.0.1:9090>**). The `task live` recipe runs templ-watch, the web-asset bundler, and an air-driven live-reloading Go server. `task` is registered as a Go tool dependency, so no separate install is needed. If you'd rather have a bare `task` on your PATH: `brew install go-task`. For a one-shot run without live reload: `go run -tags dev ./cmd/web`.
12
13
13
14
On first boot the app creates `data/atmoquest.db` (SQLite) and `data/admin_signing.key` (ed25519, badge signing). No further setup needed.
14
15
15
-
> Use `127.0.0.1`, not `localhost` — atproto OAuth requires the redirect URI to match the configured `PUBLIC_URL` exactly.
16
+
> Use `127.0.0.1`, not `localhost` — atproto OAuth requires the redirect URI to match the configured `PUBLIC_URL` exactly. If port 9090 is taken on your machine, edit `.env` and update both `PORT` and `PUBLIC_URL` to match.
16
17
17
18
## Useful routes
18
19
···
65
66
## Production build
66
67
67
68
```bash
68
-
task build # writes bin/main, embeds prod tag
69
+
go tool task build # writes bin/main, embeds prod tag
69
70
./bin/main
70
71
```
71
72