vertex

An extensible start page

Development

npm install
npm run dev

Deployment

docker compose up -d --build

The image is a static production build served by nginx. Configuration stays editable at runtime — no rebuild needed:

• data/apps.yml, data/search-providers.yml — mounted via the ./data volume and fetched by the browser on load; edit and refresh.
• VITE_* environment variables (.env, see docker-compose.yml) — read at container start by an entrypoint script that generates /config.js. Restart the container to apply changes.

Variable	Purpose
VITE_OPEN_WEATHER_KEY	OpenWeather API key for the weather widget
VITE_OPEN_WEATHER_LAT / VITE_OPEN_WEATHER_LON	Weather location
VITE_UNSPLASH_ACCESS_KEY	Unsplash API key for background images

Note: as with any client-only SPA, these keys are visible to the browser.