uFawkesDevX — Developer Experience Plane

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.

Architecture

┌────────────────────────────────────────────────────────────────────────────────────┐
│  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                         ║   │
│  ╚══════════════════════╝   ╚═════════════════════════════════════════════════╝   │
└────────────────────────────────────────────────────────────────────────────────────┘

Services

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.

Quick start

make check-gid   # find your Docker socket GID, set DOCKER_GID in .env
make network
make build && make up

See docs/quickstart.md for the full setup walkthrough, including database prerequisites and first-run steps.

Coder cloud IDE

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.

Golden paths

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 integration

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

Eclipse Che has been removed from this platform and replaced by Coder.

Research basis

• 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.

Design and brand

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.

License

See LICENSE.