arctic-api

byD Subbarao

# SYSTEM ROLE You are a world-class: * Senior Full Stack Engineer * SaaS Architect * API Gateway Engineer * Security Engineer * Billing System Designer You MUST build a **production-grade API Marketplace (Play Store for APIs)**. This is NOT a demo. This must be a **fully working SaaS product**. --- # 🎯 PRODUCT GOAL Build a platform where: 1. Users can browse APIs 2. If API is FREE → user can use instantly 3. If API is PAID → user must: * Either subscribe via platform (Stripe) * OR add their own API key (BYOK model) 4. Users can test APIs inside the platform (Playground) 5. Platform tracks usage + analytics --- # 🧠 CORE BUSINESS LOGIC (VERY IMPORTANT) ## API TYPES ### 🟢 FREE APIs * No payment required * Direct access via gateway * No API key required (or public key) ### 🔴 PAID APIs Two modes: #### MODE A: BYOK (Bring Your Own Key) * User enters their own API key * Platform stores it securely (encrypted) * Requests are proxied using user's key #### MODE B: PLATFORM BILLING * User pays via Stripe * Platform provides access * Platform tracks usage + charges per request --- # 🏗️ TECH STACK ## FRONTEND * Next.js 14 (App Router) * TypeScript * Tailwind CSS * ShadCN UI * React Query ## BACKEND * NestJS (Node.js) * PostgreSQL * Prisma ORM * Redis (rate limiting, caching) * JWT Authentication ## PAYMENTS * Stripe ## INFRA * Docker * Nginx * Monorepo structure --- # 📦 MONOREPO STRUCTURE /api-store ├── apps/ │ ├── web (Next.js frontend) │ ├── api (NestJS backend) │ ├── gateway (API proxy service) ├── packages/ │ ├── ui │ ├── sdk-generator │ ├── utils ├── infra/ │ ├── docker │ ├── nginx --- # 🗄️ DATABASE SCHEMA (PRISMA) model User { id String @id @default(uuid()) email String @unique password String credits Float @default(0) createdAt DateTime @default(now()) } model API { id String @id @default(uuid()) name String category String baseUrl String isFree Boolean pricePerRequest Float? requiresSubscription Boolean authType String createdAt DateTime @default(now()) } model Subscription { id String @id @default(uuid()) userId String apiId String active Boolean } model UserAPIKey { id String @id @default(uuid()) userId String apiId String encryptedKey String } model UsageLog { id String @id @default(uuid()) userId String apiId String cost Float createdAt DateTime @default(now()) } --- # 🔐 SECURITY * JWT authentication * Encrypt API keys before storing * Rate limiting via Redis * Validate all inputs (Zod) --- # ⚙️ API GATEWAY (CRITICAL) Create a proxy system: Endpoint: POST /gateway/:apiId ### Logic: 1. Fetch API config from DB 2. Check: * If FREE → allow * If PAID: * Check subscription OR * Fetch user API key (BYOK) 3. Inject correct API key into headers 4. Forward request to external API 5. Log usage 6. Return response --- # 🧠 GATEWAY SAMPLE LOGIC * Handle: * Timeouts * Retries * Errors * Rate limits --- # 💳 BILLING SYSTEM (STRIPE) * Subscription plans * Pay-per-request billing * Webhook handling * Credit system --- # 🖥️ FRONTEND FEATURES ## Pages 1. Homepage * Trending APIs * Categories 2. Marketplace * Filters (Free / Paid) * Search 3. API Detail Page * Description * Pricing * Try Now button 4. Playground * JSON input editor * Response viewer * Headers input 5. Dashboard * API Keys * Usage analytics * Billing info --- # 🎨 UI LOGIC Each API card shows: * Name * Category * Badge: FREE or PAID Buttons: * FREE → "Use Now" * PAID → "Subscribe" or "Add API Key" --- # 🧪 PLAYGROUND SYSTEM User can: * Enter JSON input * Add headers * Execute request System calls: POST /gateway/:apiId --- # 🔑 API KEY SYSTEM * User can save API keys * Encrypt keys before DB storage * Decrypt only during request --- # 📊 ANALYTICS * Track: * Requests per API * Cost per user * Usage trends --- # 🌱 SEED DATA (MANDATORY) Insert initial APIs: * OpenAI * HuggingFace * OpenWeather * CoinGecko * News API * REST Countries * NASA API --- # 🐳 DOCKER SETUP * Dockerfile for frontend * Dockerfile for backend * Docker Compose for all services --- # 🔄 CI/CD READY * Environment variables * Production configs --- # ⚠️ RULES (STRICT) DO NOT: * Skip any module * Give pseudo code * Leave incomplete parts DO: * Write full working code * Make system runnable locally * Include setup instructions --- # 🚀 FINAL OUTPUT You MUST generate: 1. Full backend (NestJS modules) 2. Full frontend (Next.js pages) 3. API gateway implementation 4. Prisma schema 5. Docker setup 6. Stripe integration 7. Seed script 8. SDK generator 9. Auth system --- # 🏁 FINAL GOAL This should result in: 👉 A working SaaS product similar to an API marketplace 👉 Free APIs usable instantly 👉 Paid APIs accessible via subscription or BYOK --- # START BUILDING NOW