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.
Generated from validated idea signals across reddit, hn, github
Browse all ideasAgent-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.
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 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
| Table | Key Columns | Relations |
|---|---|---|
| providers | id, userId, type, accessToken, connectedAt | belongs_to users, has_many builds |
| builds | id, providerId, projectName, status, startedAt, duration | belongs_to providers, has_many build_logs |
| alert_rules | id, userId, projectPattern, channel, events | belongs_to users |
| users | id, email, name, plan, createdAt | has_many providers, has_many alert_rules |
API Endpoints
| Method | Route | Purpose |
|---|---|---|
| GET | /api/builds | List builds with filters (project, status, date range) |
| POST | /api/providers/connect | OAuth callback to connect a CI/CD provider |
| GET | /api/analytics/deploys | Deploy frequency and success rate over time |
| POST | /api/alerts | Create or update alert rules |
| GET | /api/builds/:id/logs | Fetch detailed build logs and error output |
| POST | /api/webhooks/:provider | Receive 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 FreeWant more? Pro gives you 30 specs/month