PublicAI

PublicAI homepage

Getting Started

First, install all dependencies:

pnpm install

Run the development server:

pnpm dev

Configuration

The contact form (/business) and the official-account verification API read configuration from environment variables. .env.example documents every name; put local values in .env.local (gitignored). The server validates all of them at boot and refuses to start if any is missing or malformed.

For deployments, the values live in GitHub Actions Secrets (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION, RECAPTCHA_SECRET_KEY, CONTACT_EMAIL_TO, OFFICIAL_ACCOUNTS_JSON) and are injected into the container at runtime by the deploy workflow — they are never baked into the image. The reCAPTCHA site key is public and committed in .env.production; for local development set it in .env.local together with the server-only values.

To rotate a secret: revoke it at the provider (AWS IAM / Google Cloud console) first, then update the GitHub Secret and re-run the deploy workflow. Updating OFFICIAL_ACCOUNTS_JSON also just needs a secret edit plus a redeploy.

Docker Deploy

Build images:

docker build --platform linux/amd64 -t homepage-docker .

View current run images:

docker ps

Stop last run image:

docker container stop [CONTAINER ID]

Run latest image:

docker run -d -p 3000:3000 --name homepage-container --restart always homepage-docker

Remove last container:

docker container rm [CONTAINER ID]

Clear cache:

docker system prune -af  # force clear all unused assets
docker volume prune -f   # clear unused volume
docker builder prune -f  # clear unused build cache