uFawkesDevX is the Developer Experience plane of the Fawkes internal developer platform: Coder provisions cloud IDE workspaces, Backstage catalogs and scaffolds services, the Score service validates workload specs and triggers uFawkesPipe, and golden-path Cookiecutter templates give developers a pre-wired starting point in one command.
Start here: INTENT.md — what this repo is, its database status, and non-goals.
┌────────────────────────────────────────────────────────────────────────────────────┐
│ fawkes-net (external Docker bridge) │
│ │
│ ╔══════════════════════════╗ ╔═════════════════════════════════════════════╗ │
│ ║ External Postgres ║ ║ uFawkesDevX (this repo) ║ │
│ ║ postgres:5432 ║ ║ ║ │
│ ║ (source TBD, #57) ║ ║ gateway:8000 (nginx:1.27-alpine) ║ │
│ ╚══════════════════════════╝ ║ backstage:7007 (custom build) ║ │
│ ▲ ▲ ║ score-service:8081/8082 (custom build) ║ │
│ │ │ ║ plugin-manager:8083 (custom build) ║ │
│ Coder DB Backstage DB ║ coder:7080 (ghcr.io/coder/coder:2.34.3) ║ │
│ ╚═════════════════════════════════════════════╝ │
│ │ │
│ mounts /var/run/docker.sock │
│ │ │
│ Host Docker daemon │
│ │ │
│ ┌────────────┴────────────┐ │
│ │ Ephemeral workspace │ │
│ │ containers (devcontainer│ │
│ │ per developer session) │ │
│ └──────────────────────────┘ │
│ │
│ ╔══════════════════════╗ ╔═════════════════════════════════════════════════╗ │
│ ║ uFawkesPipe (Sec) ║ ║ uFawkesPipe ║ │
│ ║ infisical:8082 ║ ║ woodpecker-server:8000 ║ │
│ ╚══════════════════════╝ ╚═════════════════════════════════════════════════╝ │
└────────────────────────────────────────────────────────────────────────────────────┘
| Service | Port | Role |
|---|---|---|
| Coder | 7080 | Cloud IDE — provisions ephemeral devcontainer workspaces |
| Backstage | 7007 | Service catalog and scaffolding UI |
| Score service | 8081 (API), 8082 (webhooks) | Validates Score workload specs, triggers uFawkesPipe |
| Plugin Manager | 8083 | Manages platform extensions and plugins |
| Gateway | 8000 | Unified entry point — /api/score, /api/plugins |
Postgres is not run in this repo. coder, backstage, and score-service
connect to an external Postgres reachable as postgres:5432 on the fawkes-net
network (see compose.yaml). That used to be
uFawkesRes, which is deprecated; its
replacement is not decided yet (#57, suite plan AC-DEVX-01). Until it is, you
must supply that Postgres yourself.
make check-gid # find your Docker socket GID, set DOCKER_GID in .env
make network
make build && make upSee docs/quickstart.md for the full setup walkthrough, including database prerequisites and first-run steps.
Coder provisions per-developer devcontainer workspaces on the host Docker
daemon — open a workspace and you're in a container built from your
project's .devcontainer/devcontainer.json, no local toolchain setup
required. See docs/coder-guide.md.
Cookiecutter templates that scaffold a new service pre-wired for this
platform: a pinned devcontainer, a Score workload spec, and a
.fawkespipe.yml CI/CD contract. See docs/golden-paths.md.
Score workload specs (score.yaml) describe a service declaratively; the
Score service validates them and triggers uFawkesPipe builds. See
docs/score-integration.md.
Eclipse Che has been removed from this platform and replaced by Coder.
- CNCF TAG App Delivery, Platforms White Paper (2023): platforms reduce cognitive load so developers focus on business value. Golden paths follow from this.
- Noda et al., DevEx: What Actually Drives Productivity (ACM Queue, 2023): feedback loops, cognitive load and flow state.
- DORA, AI Capabilities Model (2025-11-25): quality internal platforms and user-centric focus.
Full findings and sources: research foundation, reviewed quarterly.
This repo follows the shared Fawkes and uFawkes design reference: DESIGN.md, with tokens at https://ufawkes.dev/design/tokens.json. It is owned by uFawkes.dev.
See LICENSE.