@gezelligate/studio
v0.2.0
Published
Wizard for Gezelligate. `npx @gezelligate/studio` in an empty folder fetches the catalog, scaffolds the project, and opens a browser-based wizard that renders a deployable docker-compose or Kubernetes bundle.
Maintainers
Readme
@gezelligate/studio
Browser-based wizard for Gezelligate — set up a sovereign open-source office stack (Mattermost, Drive, Meet, Docs, Bridge, Keycloak, …) without DevOps.
Quick start
mkdir my-office && cd my-office
npx @gezelligate/studioOn first run, the studio fetches the latest release of gezelligate/catalog into .gezelligate/catalog/<ref>/, scaffolds services/ and writes gezelligate.json at the project root (project metadata + pinned catalog ref under toolchain.catalog), then opens a browser at the chosen port. Re-runs in the same folder reuse the pinned catalog ref.
Options
gezelligate-studio [options]
-r, --root <dir> project root (default: cwd)
--port <port> API + UI port (default: 3000)
--no-open don't open the browser automatically
--catalog-dir <path> use a local catalog checkout instead of fetching
--catalog-ref <ref> catalog git ref (tag or sha) to pin
--dev spawn Vite dev server with HMR (monorepo contributors only)The default mode serves the pre-built bundle and the Fastify API on the same port (no proxy needed). --dev is for contributors hacking on the studio's React client.
How the wizard renders
The studio drives @gezelligate/core's render() with the @gezelligate/docker and @gezelligate/k8s targets injected. Output lands in <project>/output/{docker,kubernetes}/.
License
MIT — see LICENSE.
