Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vinum-elabel.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this page for application development. For documentation preview commands, see the repository-level migration notes in docs/README.md.

Prerequisites

  • Node.js 18 or newer for the Vite application.
  • npm.
  • A Supabase project for authentication, database, storage, and edge functions.

Install dependencies

npm install

Configure environment variables

Copy the example file and add your Supabase credentials:
cp .env.example .env.local
Required variables:
  • VITE_SUPABASE_URL
  • VITE_SUPABASE_ANON_KEY
The repository intentionally does not track .env or .env.* files.

Run the app

npm run dev
The Vite development server opens at http://localhost:5173 by default.

Useful scripts

CommandPurpose
npm run devStart the local Vite server
npm run buildBuild the app for production
npm run build:devBuild the app in development mode
npm run previewPreview the production build locally
npm run lintRun ESLint
npm run auto-translateRun the translation automation script
npm run auto-translate:previewPreview translation automation output

Supabase keep-alive

The project uses Supabase for Auth, Postgres, Storage, and Edge Functions. The current keep-alive workflow calls a harmless touch_project_heartbeat() RPC every 5 days and can also be triggered manually from GitHub Actions. This is suitable for Supabase Free projects. If production uptime becomes critical, upgrade the Supabase organization instead of adding broader data-touching keep-alive behavior.