Installing LibreAAC

July 28, 2026 · View on GitHub

LibreAAC is a static progressive web application. It needs HTTPS in production (or localhost during development) for reliable service-worker installation.

Static hosting

  1. Build the application as described in BUILD.md.
  2. Publish the complete contents of dist/ at the root of a site.
  3. Configure the host to serve index.html for navigation requests that do not match a file.
  4. Serve .webmanifest, JavaScript, CSS, SVG, and JSON files with their normal content types.
  5. Do not cache index.html indefinitely. Hashed assets may be cached for a long time; the service worker manages its own precache.

No database, server-side runtime, secrets, or environment variables are needed.

Install on a device

Visit the deployed HTTPS site in a supporting browser and use its “Install app” or “Add to Home Screen” command. Open LibreAAC once while online and wait for the page to finish loading before relying on offline use.

The Android package is built separately from the public libreaac-android repository.