The Actual News

Verifiable news ledger platform — news as a public service

standardGRADUATEDACTIVECIPlatinum

what this is

**The Actual News** — verifiable news ledger platform treating news as a public service. A pnpm monorepo with an OpenAPI-defined gateway, microservices for claims/evidence/stories/verification, and a PostgreSQL-backed audit trail. Deployed as a Next.js static export on Cloudflare Pages.

architecture

**Monorepo layout**:
```
services/
├── gateway/      # API gateway — routes all external traffic
├── claim/        # Claim submission and tracking service
├── evidence/     # Evidence attachment service
├── story/        # Story composition service
├── verify/       # Verification and audit service
apps/
└── public-web/   # Next.js 16 frontend (static export)
db/               # PostgreSQL migrations
contracts/
└── openapi/      # OpenAPI specs (source of truth — lint with Redocly)
infra/            # Docker Compose, infrastructure config
tools/
└── conformance/  # Conformance test runner
```

**Contract-first**: `contracts/openapi/*.yaml` are the canonical API definitions. Run `make lint` after editing them.

**Database**: PostgreSQL via Docker Compose locally. `POSTGRES_URI` env var required for migrations.

**Frontend** (`apps/public-web`): Next.js 16 with static export (`output: 'export'`). Deployed to Cloudflare Pages.

**Environment**: Set `PLATFORM_ID` and `POSTGRES_URI` before running make targets that need them.

Links

GitHub https://the-actual-news.pages.dev Portfolio Case Study

Git Stats

Commits: 45
Velocity: 3.5/wk
First: 2026-02-07
Last: 2026-03-17

Revenue

Model: subscription
Status: pre-launch