Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Miguelcds/App_AsignadorZonasBilbao/llms.txt

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

Asignador de Zonas de Bilbao is a purely static site — no server, no build step, no dependencies to install. You deploy it by copying the files to any static host.

Project structure

/
├── index.html
├── manifest.json
├── sw.js
├── css/styles.css
├── js/data.js
├── js/app.js
└── assets/
The Service Worker requires HTTPS in production. It works on localhost without it, but raw file:// URLs will not register the Service Worker. Use a local dev server instead of opening index.html directly from your file system.

Local development

Run a local static server from the project root:
npx serve .
The app is available at http://localhost:3000. The Service Worker registers normally on localhost.

Production deployment

1

Push your project to a GitHub repository

Make sure all project files are committed and pushed to your repository.
2

Enable GitHub Pages

Go to Settings → Pages in your repository. Under Source, select the branch you want to deploy (typically main) and choose the root folder /.
3

Save and wait for deployment

Click Save. GitHub builds and deploys your site automatically. The URL will be https://<username>.github.io/<repository>/.
4

Update the Service Worker scope (if needed)

If the app is served from a subdirectory (e.g., /repository/), verify that sw.js asset paths use ./ relative references — they already do by default.

After each deployment

Every time you update the app, bump the cache version in sw.js so users receive fresh assets:
const CACHE = 'zonas-bilbao-v6.1.0'; // ← increment on each deploy
See Service Worker for details on how cache versioning works.

Build docs developers (and LLMs) love