23 lines
1.9 KiB
Markdown
23 lines
1.9 KiB
Markdown
# AnchorHost.eu frontend
|
|
|
|
React single-page application for the AnchorHost.eu hosting platform. The app source was recovered from the production image source maps; static runtime assets are in `public/assets`. The deployed bundle and its maps are retained under `recovered-production/` as a reference snapshot.
|
|
|
|
## Development
|
|
|
|
1. Install Node.js 24 LTS or newer and npm.
|
|
2. Run `npm ci`.
|
|
3. Copy `.env.example` to `.env` and set the API/WebSocket URLs as needed.
|
|
4. Run `npm run dev` (or `npm start`).
|
|
|
|
`npm run build` creates the production bundle in `dist/`. The included Dockerfile serves it with nginx and supports client-side routes. Vite expects JSX files to use `.jsx`; keep `.js` for plain JavaScript modules.
|
|
|
|
## Rebrand the deployment
|
|
|
|
Edit the root `branding.json` to set the product name, domain, logo path, public copy, contact addresses, documentation and source links, and footer credit. Replace the logo file at the configured path under `public/`. The app imports this file for its UI, API defaults, document metadata, and web app manifest. Keep `.env` API and WebSocket overrides for deployments whose service endpoints differ from the public brand domain.
|
|
|
|
## Gitea Actions Docker publishing
|
|
|
|
`.gitea/workflows/docker.yml` builds the Docker image when `main` is updated and can also be started manually from the Actions page. It publishes `git.anchorhost.eu/anchorhost.eu/anchorhost-frontend:main-latest` and a commit-specific `main-<12 character SHA>` tag to the Gitea Container Registry. The workflow uses Gitea's job token with only `contents: read` and `packages: write`; no registry password secret is needed.
|
|
|
|
Enable Actions and the Container Registry for the repository, and register an `ubuntu-latest` runner that has the Docker CLI and access to a working Docker daemon. The workflow cannot build until that runner is available. `.dockerignore` keeps local dependencies, Git history, build output, and recovered production artifacts out of the build context.
|