RepliMap

AWS Infrastructure Intelligence Platform

Website | Documentation | Changelog

---

What is RepliMap?

RepliMap scans your AWS production environment and generates Terraform code to replicate it for staging, disaster recovery, or compliance testing.

Architecture Overview

graph TB
    subgraph "User Environment"
        AWS[("AWS Cloud<br/>Production")]
        CLI["RepliMap CLI<br/>(Python)"]
        TF["Terraform Code<br/>Generated"]
    end

    subgraph "RepliMap Platform"
        WEB["Dashboard<br/>(Next.js on Vercel)"]
        API["API<br/>(Hono on CF Workers)"]
        DB[("D1 Database")]
        STRIPE["Stripe<br/>Billing"]
        CLERK["Clerk<br/>Auth"]
    end

    CLI -->|"1. Scan"| AWS
    CLI -->|"2. Generate"| TF
    CLI -->|"3. Validate License"| API
    WEB -->|"Auth"| CLERK
    WEB -->|"Checkout"| STRIPE
    STRIPE -->|"Webhooks"| API
    API --> DB

    style AWS fill:#FF9900,stroke:#232F3E,color:#232F3E
    style CLI fill:#10b981,stroke:#10b981,color:white
    style API fill:#F38020,stroke:#F38020,color:white
    style WEB fill:#000000,stroke:#000000,color:white
    style TF fill:#7B42BC,stroke:#7B42BC,color:white
    style STRIPE fill:#635BFF,stroke:#635BFF,color:white
    style CLERK fill:#6C47FF,stroke:#6C47FF,color:white

Loading

Packages

Package	Description	Version	Status
@replimap/web	Next.js Dashboard	Internal
@replimap/api	Hono API	Internal
@replimap/config	Shared Config	Internal	-

Development

Prerequisites

Tool	Version	Installation	Notes
Node.js	24.x	nodejs.org	Required for web/api
pnpm	9.x	corepack enable	Package manager
Make	any	Pre-installed on Linux/macOS	See Windows section

Setup

# Clone the repository
git clone https://github.com/RepliMap/replimap-mono.git
cd replimap-mono

# First-time setup (installs all dependencies)
make setup

# Start development servers
make dev-web   # Web on http://localhost:3000
make dev-api   # API on http://localhost:8787

Available Commands

Run make help for full list. Key commands:

# Development
make dev          # Start all dev servers
make build        # Build all packages
make test         # Run all tests

# Quality
make lint         # Run linters
make typecheck    # Type checking
make pre-commit   # All checks before committing

# Deployment
make deploy-web   # Deploy to Vercel
make deploy-api   # Deploy to Cloudflare

# Utilities
make info         # Show environment info
make clean        # Clean build artifacts

Commercial Flow (Checkout + License Delivery)

RepliMap's paid tier is powered by Stripe Checkout + an idempotent license webhook. Visitors go:

Landing  ──►  /sign-up (Clerk)  ──►  /dashboard (community license auto-provisioned)
   │
   └─ Pricing ──► /checkout?plan=pro&billing=monthly ──► Stripe  ──► /checkout/success
                                                            │
                                                            └── webhook creates license
                                                                success page polls + displays key

All three tiers (community / pro / team) and all billing cadences (monthly / annual / lifetime) share this flow. See docs/testing/commercial-flow.md for the full test harness and prerequisites.

E2E tests:

./scripts/e2e-commercial-flow.sh           # full suite (requires stripe CLI)
./scripts/e2e-commercial-flow.sh community # community signup only (no Stripe)

Windows Development

Click to expand Windows setup instructions

Option 1: WSL2 (Recommended)

# Install WSL2 with Ubuntu
wsl --install -d Ubuntu

# Inside WSL, follow standard Linux setup
cd /mnt/c/path/to/replimap-mono
make setup

Option 2: PowerShell Commands

If you cannot use WSL, here are PowerShell equivalents:

# Install dependencies
corepack enable
pnpm install

# Build
pnpm build

# Development
pnpm --filter @replimap/web dev
pnpm --filter @replimap/api dev

Option 3: Git Bash

Install Git for Windows which includes Git Bash, then run make commands normally.

Project Structure

replimap-mono/
├── apps/
│   ├── web/              # Next.js 16 frontend (Vercel)
│   │   ├── src/
│   │   │   ├── app/
│   │   │   │   ├── (auth)/       # Clerk sign-in/sign-up
│   │   │   │   ├── checkout/     # Stripe checkout flow
│   │   │   │   ├── dashboard/    # User dashboard
│   │   │   │   └── docs/         # Documentation
│   │   │   ├── components/       # React components
│   │   │   └── lib/              # API client, pricing config
│   │   ├── package.json
│   │   └── vercel.json
│   └── api/              # Hono + Cloudflare Workers
│       ├── src/
│       │   ├── handlers/         # billing, webhooks, license, usage
│       │   ├── lib/              # constants, rate-limiter, errors
│       │   └── db/               # Drizzle ORM schema
│       ├── package.json
│       └── wrangler.toml
├── packages/
│   └── config/           # Shared configuration (plans, features)
├── .github/workflows/    # CI/CD pipelines
├── Makefile              # Development commands
├── turbo.json            # Turborepo config
├── DEPLOYMENT.md         # Deployment + Stripe setup guide
├── CHANGELOG.md
└── LICENSE

Security

We take security seriously. Our security measures include:

• OIDC-based publishing - No long-lived secrets for deployments
• Dependabot - Automated dependency updates
• SOC2 compliance - Enterprise-grade infrastructure

See SECURITY.md for vulnerability reporting.

License

This project is proprietary software. See LICENSE for details.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Citation

If you use RepliMap in academic work, please cite:

@software{replimap,
  title = {RepliMap: AWS Infrastructure Intelligence Platform},
  author = {RepliMap Team},
  year = {2025},
  url = {https://github.com/RepliMap/replimap-mono}
}

---

Built with care in New Zealand