Back to the vault
DEVELOPER TOOLSIN DEVELOPMENT

Shipwreck

Find what sinks before you ship.

PROJECT / 05

An evidence-first production-readiness scanner. Inspect a repository, surface concrete launch blockers, and turn findings into a repair plan.

View source
PLATFORMWeb / CLI
TECHNOLOGYNext.js / TypeScript / PostgreSQL
DEVELOPMENTin development · v0.1.0
THE REASON

Why I built it.

A project that runs locally can still have plenty of ways to fail in production. The goal is a report with evidence, severity, and an actual next step.

What’s inside

Deterministic production-readiness checks
Evidence-linked findings and remediation
Persistent scan history and project reports
Shared repository scanner for web and CLI
UNDER THE HOOD

Small pieces. Clear boundaries.

01

Scanner

A framework-independent TypeScript engine inspects repository files without executing them.

02

Application

Next.js serves the dashboard and API.

03

Storage

PostgreSQL persists workspaces and reports, with embedded PGlite for development.

A CLOSER LOOK

A few moments inside Shipwreck.

From the first screen to the details that make it useful.

01 / THE WORKFLOW

A Hull Check, with evidence

The production report separates critical findings, warnings, and passing checks so the next review is focused.

Web · local demo workspace
02 / THE WORKFLOW

From finding to next step

Open a finding to inspect the source evidence, understand uncertainty, and prepare a targeted fix prompt.

Web · local demo workspace
03 / THE WORKFLOW

Know the environment

An environment inventory shows required configuration and where each variable appears in the repository.

Web · local demo workspace
INSIDE THE APPLICATIONShipwreck
01 / 04
shipwreck — Your launch control center

Your launch control center

A fleet overview brings production readiness, critical findings, and scan activity together across projects.

Web · local demo workspace · ← → to explore · Esc to closeSwipe to explore · + to inspect
ON YOUR MACHINE

Take it for a spin.

Requires Node.js 22.13+. Local development includes an isolated demo workspace. See the README before configuring GitHub access.

View source
From shipwreck/
npm ci
cp .env.example .env.local
npm run dev
NEXT IN THE VAULTRepo Reaper
OPEN A CHANNEL

Something on your mind?

A project, a strange idea, or a particularly good bug. Find me here.

github.com/Rippley777