Multi-tenant, API-first publishing platform for podcast creators and digital publishers who want their own domain, subscribers, and distribution — without renting Patreon, Steady, or a closed CMS.
Primary users: creators in directwerk-studio and audiences on
directwerk-web. Integrators and agencies use the same public REST API and
OpenAPI spec; no private shortcuts.
| Layer | What ships | Who uses it |
|---|---|---|
| Backend | Spring Boot API, PostgreSQL, jobs, S3, module gating | All clients |
| Creator tools | directwerk-studio — Write + Podcast desks, media, products |
Tenant admins & editors |
| Platform ops | directwerk-admin — tenants, modules, audit |
PLATFORM_ADMIN |
| Public site | directwerk-web — catalog, auth, subscriber portal, feeds UI |
Visitors & subscribers |
| End-customer UI | Commissioned site or BYO frontend | Optional per tenant |
Detailed product and architecture reference:
docs/platform-design.md. Internal doc index:
docs/README.md.
| Path | Role |
|---|---|
Directwerk/ |
Gradle backend — Spring Boot 4.1, Java 21, Flyway, PostgreSQL |
directwerk-studio/ |
Creator dashboard (port 3003) |
directwerk-web/ |
Public + subscriber site (port 3004) |
directwerk-admin/ |
Platform superadmin (port 3001) |
homepage/ |
Marketing site + /developers API excerpt (port 3005) |
directwerk-docs/ |
Public VitePress docs (dev 5173, container 8088) |
packages/ui, packages/api |
Shared Next.js UI and typed API client |
docs/ |
Internal implementation and product docs |
Package namespace: de.pnnit.directwerk.
API (day-to-day): from Directwerk/ — Postgres + Mailpit via Compose, app via Gradle.
cd Directwerk
cp .env.example .env # DB password + OAuth / seed secrets
docker compose up -d # Postgres :5433, Mailpit SMTP :1025 / UI :8025
./gradlew :directwerk-app:bootRun| URL | Purpose |
|---|---|
| http://localhost:8080/actuator/health | Health |
| http://localhost:8080/swagger-ui.html | OpenAPI UI |
| http://127.0.0.1:8025 | Mailpit (captured email) |
Frontends: pnpm install at repo root, then pnpm dev in each app (see app READMEs).
Full stack in Docker (API + all frontends + docs):
docker compose --env-file Directwerk/.env -f docker-compose.full-stack.yaml up --buildAuthoritative run/deploy guide:
Directwerk/docs/build-and-deploy.md.
| Document | Use when |
|---|---|
Directwerk/docs/build-and-deploy.md |
Running, building, or deploying the API |
Directwerk/docs/multi-tenancy.md |
Host routing, tenant isolation, JWT |
Directwerk/docs/jobs-and-email.md |
Job queue, transactional email |
docs/platform-design.md |
Full product/architecture design spec |
docs/poc-alpha-setup.md |
Alpha setup + HTTP harness run order |
docs/directwerk-studio.md |
Creator dashboard product context |
docs/asset-storage.md |
S3 upload/confirm, entitlements, CDN |
docs/content-subscriptions-and-entitlements.md |
LEVEL/PACKAGE products and access |
docs/payment.md |
Stripe Connect |
directwerk-docs/ |
Public install, operators, API reference |
Directwerk/bruno/ + Directwerk/http/ |
Manual API tests — keep in sync with controllers |
AGENTS.md |
Agent-oriented commands, security, domain summary |
docs/README.md |
What is current vs historical |
Regenerate public API docs after controller changes:
./Directwerk/gradlew :directwerk-app:exportOpenApi
pnpm --filter directwerk-docs buildflowchart TB
subgraph clients [Clients]
Studio[directwerk-studio]
Web[directwerk-web]
Admin[directwerk-admin]
BYO[Custom frontend]
Podcatcher[Podcast app]
end
subgraph platform [Directwerk]
API[Spring Boot REST API]
PG[(PostgreSQL)]
S3[(S3 EU)]
API --> PG
API --> S3
end
Studio --> API
Web --> API
Admin --> API
BYO --> API
Podcatcher -->|RSS| API
Core ideas:
- Multi-tenancy — verified
Host→ tenant context; Hibernate tenant filter + JWT cross-check. - Feature modules —
DIGITAL_CONTENT→PODCAST→PODCAST_RSS→FEED_BUILDER, and in parallel →ARTICLES→ARTICLE_RSS→ARTICLE_FEED_BUILDER, and →BONUS_CONTENT(subscriber downloads); gated with@RequiresModule. - API-first — every capability has REST endpoints; OpenAPI is a product deliverable.
- Entitlements —
SUBSCRIBERrole ≠ paid access; LEVEL + PACKAGE rules on content and feeds. - Assets — tenant-prefixed S3 keys; private media only via signed URLs after entitlement check.
Roles: PLATFORM_ADMIN, TENANT_ADMIN, EDITOR, SUBSCRIBER, GUEST.
Billing sources (unified model): STRIPE, PATREON, STEADY, MANUAL.
Shipped: multi-tenant API, auth, module gates, media upload, podcast + newsletter desks, public and private RSS, feed builder, subscription products and entitlements, reference studio/web/admin UIs, Stripe scaffold.
In progress / env-dependent: live Stripe billing in production, Patreon/Steady dual-run, subscriber email notifications, backend CI on every PR.
Historical phase notes: docs/poc-alpha-setup.md.
Java 21 · Spring Boot 4.1 · Gradle 9 · Flyway 12+ · PostgreSQL 19 (beta) · Hetzner/Bunny S3 (EU) ·
Next.js 16 + Tailwind v4 (@directwerk/ui) · Stripe Connect · Patreon/Steady (planned)
# Backend tests (from Directwerk/)
./gradlew test
# Frontend workspace (from repo root)
pnpm install
pnpm test && pnpm typecheck && pnpm buildCI (.github/workflows/ci.yml): pnpm test, typecheck, and build for
Next.js apps. Run ./gradlew test locally before merging backend changes.
Last updated: 2026-08