Overview
There are two paths to a working Flexweg CMS, depending on whether you're a developer who wants to build the admin yourself, or a user who's been given a pre-built dist/ to drop on Flexweg.
Firebase project
Flexweg CMS uses Firebase for two things:
Firestore rules
Firestore rules are the only thing protecting your CMS data. Without them, anyone on the internet could read and modify your posts, settings, even create user records and grant themselves admin. The Firebase config (apiKey, projectId, etc.) is public by design — security comes from the rules + the auth domain allowlist, not from the secrecy of the config.
Plan limits
Both Flexweg and Firebase have plan limits. Stay under them or pay; either way, monitor them so you don't get surprised mid-publish.
Flexweg setup
Flexweg is the static hosting service that holds both your public site (visitors browse this) and your admin SPA (you log in here). The CMS interacts with Flexweg through its Files API — every publish, every theme sync, every plugin/theme install pushes files via this API.
Updating the admin
WordPress has built-in core/plugin/theme updates. Flexweg CMS doesn't — you build the new admin yourself (or download a release), upload the new dist/admin/ to Flexweg, and the new code is live.
First-run setup
When you visit https:///admin/ for the first time after uploading dist/admin/, the admin detects there's no Firebase configuration baked in (because config.js ships as a null stub for the no-build path) and renders an in-admin setup wizard instead of the normal sign-in page.
Troubleshooting
The most common problems and how to fix them. Skim the section that matches your symptom.
Local development
This page is for developers who want to run the admin locally with hot module reload, write plugins or themes against live admin code, or contribute to the CMS itself.
Deployment
Once you have a dist/ folder (either built locally with npm run build or downloaded from a release), deploying to Flexweg means uploading two folders to two specific locations on your Flexweg site.
Renaming /admin/
By default the admin SPA is deployed to /admin/ on Flexweg. You can rename that folder to anything you want — for example a random-looking string like /erf34f654GH3/ — to make it harder for crawlers and casual scanners to find the admin URL.