Julien Maille 97e076e2ee Fix: Cloudflare Pages 404 by making base path dynamic

- Default base to '/' for root deployments and local dev
- Use VITE_BASE_PATH env var in GitHub Actions for subdirectory hosting
- Update documentation and local dev URL

2026-01-07 21:51:21 +01:00

1.6 KiB

Raw Blame History

Monochrome Music

A minimalist music streaming application designed for high-fidelity audio playback.

Development

This project uses Vite for local development and optimized builds.

Prerequisites

Node.js (Version 20+ or 22+ recommended)

Getting Started

Install dependencies:
```
npm install
```
Start the development server:
```
npm run dev
```
The app will be available at http://localhost:5173/.

Why Vite?

Instant Updates: Support for Hot Module Replacement (HMR) means changes to JS/CSS are reflected instantly in the browser.
Dependency Management: No more manual path tracking or broken internal imports.
Automated PWA: Service Worker generation and asset hashing are handled automatically.

Project Structure

/js: Application source code.
/public: Static assets (images, manifest, instances.json) that are copied directly to the build folder.
index.html: The entry point of the application.
vite.config.js: Build and PWA configuration.

Deployment

Deployment is automated via GitHub Actions.

Note

The project uses a relative base path (./) in vite.config.js. This allows the exact same build artifact to work on both Cloudflare Pages (served from root) and GitHub Pages (served from /monochrome/), provided that Hash Routing is used.

Simply push your changes to the main branch.
The Deploy to GitHub Pages workflow will trigger automatically.
It builds the project (npm run build) and publishes the dist/ folder to the deployed-ver branch.

1.6 KiB Raw Blame History