ShipWatch

Solo developers and indie hackers juggle multiple projects across GitHub Actions, Vercel, Railway, and Fly.io with no unified dashboard for build status and deploy health.

12 sourcesSignal: 87/100Trend: Rising

Generated from validated idea signals across reddit, hn, github

Browse all ideas

Agent-Ready Spec: ShipWatch

Generated specification ready for your AI coding agent

Problem

Solo developers and indie hackers juggle multiple projects across GitHub Actions, Vercel, Railway, and Fly.io with no unified dashboard for build status and deploy health.

12 sourcesSignal: 87/100Trend: rising

User Stories

As Solo developer, I want connect my GitHub and Vercel accounts in one click so that I can see all build statuses in a single dashboard without switching tabs

  • OAuth flow completes in under 10 seconds
  • Dashboard shows builds from all connected providers
  • Build status updates within 30 seconds of change

As Indie hacker with 3 side projects, I want get notified immediately when a deploy fails so that I can fix production issues before users notice

  • Slack/Discord notification within 60 seconds of failure
  • Notification includes error summary and link to logs
  • Configurable alert rules per project

As Small team lead, I want view deploy frequency and success rates over time so that I can identify reliability trends and improve our shipping velocity

  • 30-day rolling chart of deploys per day
  • Success rate percentage with trend indicator
  • Filterable by project and provider

Technical Architecture

Stack

Next.js 15 (App Router)Tailwind CSSDrizzle ORM + PostgreSQLUpstash Redis

Next.js for SSR + API routes in one deploy. Drizzle for type-safe DB access. Redis for caching build data and rate limiting provider API calls.

Database Schema

TableKey ColumnsRelations
providersid, userId, type, accessToken, connectedAtbelongs_to users, has_many builds
buildsid, providerId, projectName, status, startedAt, durationbelongs_to providers, has_many build_logs
alert_rulesid, userId, projectPattern, channel, eventsbelongs_to users
usersid, email, name, plan, createdAthas_many providers, has_many alert_rules

API Endpoints

MethodRoutePurpose
GET/api/buildsList builds with filters (project, status, date range)
POST/api/providers/connectOAuth callback to connect a CI/CD provider
GET/api/analytics/deploysDeploy frequency and success rate over time
POST/api/alertsCreate or update alert rules
GET/api/builds/:id/logsFetch detailed build logs and error output
POST/api/webhooks/:providerReceive real-time build events from providers

Key Components

BuildFeed (real-time list), ProviderConnect (OAuth flow), AnalyticsDashboard (charts), AlertRuleEditor (config UI)

MVP Scope (48 hours)

Must Have

  • GitHub Actions + Vercel integration
  • Real-time build status feed
  • Email failure alerts
  • 30-day deploy analytics

Skip for Now

  • AI-powered failure triage
  • Railway and Fly.io integrations
  • Team/org features
  • Mobile PWA

Agent Instructions (CLAUDE.md)

# ShipWatch — CLAUDE.md

## Project Overview
Real-time CI/CD dashboard for solo developers. MVP: GitHub Actions + Vercel.

## Tech Stack
- Next.js 15 (App Router) + Tailwind CSS
- Drizzle ORM + PostgreSQL (Supabase)
- Upstash Redis for caching
- GitHub OAuth + Vercel API

## Key Conventions
- All API routes in `src/app/api/`
- Database schema in `src/db/schema.ts`
- Provider adapters implement `ProviderAdapter` interface
- Use Zod for all request validation
- Never store raw access tokens — encrypt at rest

## Commands
```bash
npm run dev        # Start dev server
npm run db:push    # Push schema changes
npm test           # Run test suite
```

Sources

Like What You See?

Sign up free to generate your first agent-ready spec from any idea. Hand it to Claude Code or Cursor and start building in minutes.

Get Started Free

Want more? Pro gives you 30 specs/month

ShipWatch — Agent-Ready Spec | ZeroToShip