ShipStack A2A

Full-stack project scaffolding via Agent-to-Agent protocol. Initialize projects, add database layers, authentication, API routes, Stripe payments, email, deployment configs, testing, and monitoring — all through A2A skill invocations.

Supports Next.js, Express, and Fastify with TypeScript, Prisma/Drizzle/Knex, JWT/session/OAuth, and 4 deployment platforms.

Architecture

graph LR
    Client[AI Agent] --> SS[ShipStack A2A<br/>Port 3011]
    SS -->|init-project| P[New Project]
    SS -->|add-database| DB[(PostgreSQL<br/>MySQL · SQLite)]
    SS -->|add-auth| Auth[JWT · Session<br/>OAuth]
    SS -->|add-payments| Stripe[Stripe<br/>Webhooks]
    SS -->|add-deployment| Deploy[Vercel · Railway<br/>Docker · Fly.io]

    style SS fill:#c2410c,stroke:#f97316,color:#fff7ed
    style Client fill:#1e293b,stroke:#f97316,color:#e2e8f0

Quick Start

npm install -g shipstack-a2a
shipstack-a2a

Skills

| Skill | Description | Tier | |:------|:-----------|:-----| | init-project | Initialize Next.js/Express/Fastify project with TypeScript | Free | | add-database | Add PostgreSQL/MySQL/SQLite with Prisma/Drizzle/Knex | Free | | add-auth | Add JWT/session/OAuth authentication | Free | | add-api-routes | Scaffold CRUD API routes with Zod validation | Free | | add-env-config | Generate typed environment variable configuration | Free | | project-status | Show installed features, health checks, recommendations | Free | | list-templates | List all available frameworks, databases, ORMs, platforms | Free | | add-payments | Add Stripe payments (one-time, subscription, or both) | Pro | | add-email | Add Resend/SendGrid/Nodemailer transactional email | Pro | | add-deployment | Add Vercel/Railway/Fly.io/Docker deployment config | Pro | | add-testing | Add Vitest/Jest with unit/integration/e2e scaffolding | Pro | | add-monitoring | Add Sentry/PostHog/custom error tracking | Pro | | generate-readme | Auto-generate README from project manifest | Pro |

Usage

# Initialize a project
curl -X POST http://localhost:3011/tasks \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"init-project","params":{"name":"my-app","framework":"nextjs"}}'

# Add database
curl -X POST http://localhost:3011/tasks \
  -d '{"jsonrpc":"2.0","id":2,"method":"add-database","params":{"project_path":"/path/to/my-app","database":"postgresql","orm":"prisma"}}'

# List available options
curl -X POST http://localhost:3011/tasks \
  -d '{"jsonrpc":"2.0","id":3,"method":"list-templates","params":{"category":"frameworks"}}'

Environment Variables

| Variable | Description | Default | |:---------|:-----------|:--------| | PORT | Server port | 3011 | | PRO_LICENSE | License key for Pro skills | — |

License

MIT