Environment Variables

Copy .env.example to .env at the project root:

cp .env.example .env   # macOS/Linux
copy .env.example .env  # Windows

Every variable has a working default — the app boots without any configuration.

---

Server

PORT

Default: 8080

HTTP listen port.

PORT=8080

---

Database

DATABASE_URL

Default: wick.db (SQLite file in the project root)

Leave blank to use SQLite — no database setup required. SQLite is fine for local development and small deployments.

# SQLite (default — no config needed)
DATABASE_URL=

# PostgreSQL
DATABASE_URL=postgres://user:password@localhost:5432/myapp?sslmode=disable

---

App

APP_NAME

Default: (empty — falls back to "Wick")

App name shown in the UI. Only used on first boot to seed the database. After that, change it from /admin/configs — the database value always wins.

APP_NAME=My Internal Tools

APP_URL

Default: http://localhost:8080

Base URL used for SSO callbacks and absolute links. Only used on first boot. Change it from /admin/configs after the first run.

APP_URL=https://tools.example.com

---

Admin

APP_ADMIN_EMAILS

Default: admin@admin.com

Comma-separated list of emails automatically granted the admin role on first login. Env-only by design — admins cannot remove themselves from this list via the UI.

APP_ADMIN_EMAILS=alice@example.com,bob@example.com

APP_ADMIN_PASSWORD

Default: admin

Password for the admin account created on first boot (only if no admin user exists yet). Ignored on every subsequent boot. Change it from the UI after first login.

APP_ADMIN_PASSWORD=changeme

---

UI Stack

Wick uses Tailwind CSS for styling and templ for HTML templating. Both are set up automatically by go run . setup — no manual configuration needed.

Tool	What it does	Managed by
Tailwind CSS	Utility-first CSS	wick.yml setup task downloads the standalone CLI
templ	Type-safe Go HTML templates	wick.yml setup task installs templ via go install

The go run . dev command runs templ generate and rebuilds CSS automatically before starting the server.

For AI agents

Tailwind classes live in .templ files only. Never edit *_templ.go by hand — it is regenerated by templ generate.