This repository contains the code for the Web Gallery of Art project. The project is a web application that allows users to browse through a collection of paintings, sculptures and other forms of Art. This project is intended to shave off the 3 decades of tech debt on the original website and provide a modern, responsive and user friendly experience with the same content.
The project is built around the following active technologies and workflows:
- Go 1.26.5 with PocketBase for the application server, data layer, hooks, and cron jobs
- Templ for server-rendered UI fragments and page composition
- Bun scripts for frontend dependency management and asset builds
- PostCSS plus Tailwind tooling for stylesheet compilation
- htmx for incremental browser interactions
- Playwright for browser end-to-end coverage
Copy .env.example to .env in the directory from which you start the application. mise run app:init-env creates it in the repository root for mise run code:run; copy it to dist/.env when using mise run app:run.
WGA_ENV=development
WGA_ADMIN_EMAIL=
WGA_ADMIN_PASSWORD=
WGA_S3_ENDPOINT=http://127.0.0.1:3900
WGA_S3_BUCKET=wga-assets
WGA_S3_REGION=garage
WGA_S3_ACCESS_KEY=GKlocaluploads
WGA_S3_ACCESS_SECRET=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
WGA_PROTOCOL=http
WGA_HOSTNAME=localhost:8090
WGA_SMTP_HOST=127.0.0.1
WGA_SMTP_PORT=1025
WGA_SMTP_USERNAME=
WGA_SMTP_PASSWORD=
WGA_SENDER_ADDRESS=do-not-reply@wga.hu
WGA_SENDER_NAME=WGA
WGA_POSTCARD_FREQUENCY="*/1 * * * *"
WGA_RECAPTCHA_SITE_KEY=
WGA_RECAPTCHA_SECRET=
MAILPIT_URL=http://127.0.0.1:8025| Variable | Description |
|---|---|
WGA_ENV |
The environment the application is running in: development, test, staging, or production |
WGA_ADMIN_EMAIL |
Optional email address for the bootstrap administrator |
WGA_ADMIN_PASSWORD |
Optional unique password for the bootstrap administrator |
WGA_S3_ENDPOINT |
The absolute S3-compatible object storage service endpoint |
WGA_S3_BUCKET |
The name of the S3 bucket |
WGA_S3_REGION |
The region of the S3 bucket |
WGA_S3_ACCESS_KEY |
The access-key ID for the S3-compatible object storage service |
WGA_S3_ACCESS_SECRET |
The access secret for the S3-compatible object storage service |
WGA_PROTOCOL |
The protocol to use for the application, valid values are http and https |
WGA_HOSTNAME |
The domain pointing to the application |
WGA_SMTP_HOST |
The address of the SMTP host |
WGA_SMTP_PORT |
The SMTP service port on the host address |
WGA_SMTP_USERNAME |
The username for the SMTP service |
WGA_SMTP_PASSWORD |
The password for the SMTP service |
WGA_SENDER_ADDRESS |
The sending email address |
WGA_SENDER_NAME |
The name of the email sender |
WGA_POSTCARD_FREQUENCY |
The five-field cron expression for sending queued postcards |
WGA_RECAPTCHA_SITE_KEY |
The reCAPTCHA site key rendered in the postcard widget; required in staging and production |
WGA_RECAPTCHA_SECRET |
The reCAPTCHA secret used to verify postcard submissions; required in staging and production |
MAILPIT_URL |
The local Mailpit HTTP endpoint that Playwright queries during end-to-end tests |
Local development and test environments may omit WGA_RECAPTCHA_SITE_KEY and WGA_RECAPTCHA_SECRET; staging and production cannot start without both.
The administrator bootstrap is optional. Before the first application start, set both WGA_ADMIN_EMAIL and WGA_ADMIN_PASSWORD to unique values; leave both empty to skip it.
To run the application simply download the release for your platform and run it with:
./dist/wga serveThe application will start on port 8090 by default. You can access it by going to http://localhost:8090
The canonical build path uses Mise, which installs the pinned tools and defines the project tasks:
mise install
mise run app:buildThis produces the server binary at dist/wga.
The equivalent build steps are:
mkdir -p dist
bun install
bun run build
templ generate
go mod tidy
go build -o dist/wga ./cmd/wgaTemplate sources live in internal/assets/templ/, generated *_templ.go files live beside those sources, and built frontend assets land in internal/assets/public/.
Contributions are welcome. Please read CONTRIBUTING.md for more information.
Start the local asset watchers and services with Mise:
mise run devmise run dev brings up the Podman Compose Mailpit and Garage services, then starts the frontend and template watchers. Mailpit exposes SMTP on port 1025 and its HTTP API on port 8025; Playwright reads MAILPIT_URL to query captured messages. Garage exposes S3-compatible storage on port 3900. In another terminal, start the application with mise run code:run, or run mise run app:build followed by mise run app:run. mise run app:reset brings up and waits for Garage while rebuilding and replacing dist/wga_data.
If you only need asset watchers, use the package scripts directly:
bun run build:watch:css
bun run build:watch:jsThe first application start on a fresh data directory applies the embedded synthetic-data migration. It imports records into the existing collections and attaches the bundled artwork and music files to the configured filesystem or S3-compatible storage.
The bootstrap migration skips an existing non-system application database rather than merging or replacing it. Changing the embedded source later requires a new migration; it does not rerun on an existing data directory. The development-only seed:images command remains available for placeholder-image generation.
Mise manages the project's development tools and tasks. Install Mise following its getting-started guide, then run:
mise install
mise run app:init-envmise.toml defines the pinned tools, local environment defaults, build tasks, watchers, and Podman Compose local services.
This project is licensed under the MIT License - see the LICENSE.md file for details