Architecture

Stack

All ShipShit.dev apps share a common technology stack:

Layer	Technology
Framework	Next.js 16
Runtime	Bun
Styling	Tailwind CSS v4
Auth	Clerk (shared single app)
Database	MongoDB Atlas
Hosting	Vercel
AI	Vercel AI SDK + OpenRouter
Package Manager	Bun

Shared Infrastructure

Authentication

All apps share a single Clerk application (free tier). This means:

One user pool across all apps
Single sign-on between apps
Shared user metadata

AI Layer

The @shipshit/ai SDK provides cross-app intelligence. See ADR-001 for the full architecture.

Design System

All apps follow the same design language:

Background: gray-950, gray-900, gray-800
Text: gray-100, gray-400
Accent: blue-500, blue-600
Font: System fonts (Inter when custom)

Repository Structure

Each app lives in its own repository under the shipshitdev GitHub organization:


shipshitdev/
├── slides.shipshit.dev    # Presentation platform
├── sdr                     # Sales development
├── cal                     # Calendar & booking
├── todo                    # Task management (VincentShipsIt/todo)
├── ai.shipshit.dev        # AI playground & API
├── ai-sdk                  # @shipshit/ai SDK
├── docs.shipshit.dev      # This documentation
├── status.shipshit.dev    # Uptime monitoring
├── links.shipshit.dev     # Link-in-bio
├── paste.shipshit.dev     # Code snippets
├── meterbar.app           # macOS menu bar monitor
├── homebrew-tap           # Homebrew cask formulas
├── library                # AI agent skills
└── agents                 # Agent configurations