Skip to content

Repository files navigation

AI Tool Roadmapper

From idea to AI stack in minutes.

AI Tool Roadmapper is an open-source tool that helps founders and developers discover the best AI tools for their startup. Describe your idea in plain English, chat with Claude to refine your requirements, and receive a complete AI tool stack recommendation with a visual interactive roadmap — showing what to build when, estimated costs, and alternatives.

Screenshot

License: MITBuilt with Next.jsPowered by SupabaseAnthropic ClaudeStatus: Alpha


Features

  • Conversational requirements gathering — Claude asks the right questions to understand your use case, team size, and budget before making any recommendations.
  • Manually curated tool database — A vetted, categorized database of 150+ AI tools with pricing and capability metadata.
  • Visual interactive roadmap — A React Flow graph showing your recommended stack organized by phase, with dependency arrows and timeline guidance.
  • Cost estimation — Per-tool and total stack cost estimates based on your expected usage.
  • Alternatives — Every recommendation includes alternatives so you can make informed trade-offs.
  • Export — Copy or download your roadmap as structured data.
  • Background enrichment — Inngest-powered jobs handle tool classification, scoring, and embedding generation.

How It Works

  1. Describe — Type a brief description of your startup idea or the problem you are solving.
  2. Chat — Claude asks targeted clarifying questions: your technical constraints, team size, budget, timeline, and must-have integrations.
  3. Generate — The planner service queries the vector database, scores tools against your requirements, and produces a phased roadmap.
  4. Export — Share or save your personalized AI stack recommendation.

Tech Stack

LayerTechnology
FrontendNext.js 14, React 18, TypeScript, Tailwind CSS
Graph VisualizationReact Flow (@xyflow/react)
AI / LLMAnthropic Claude via AI SDK
DatabaseSupabase (PostgreSQL + pgvector)
ORMDrizzle ORM
Background JobsInngest
MonorepoTurborepo + pnpm workspaces
DeploymentSupabase (DB)

Monorepo Services

Package / ServicePurpose
apps/webNext.js application and API routes
packages/dbDrizzle schema, migrations, Supabase client
packages/promptsShared Claude prompt templates
packages/schemasShared Zod schemas
packages/scoringTool scoring and ranking logic
services/enrichTool metadata enrichment (classifier, deduplicator)
services/plannerRoadmap generation and tool retrieval

Getting Started

Prerequisites

1. Clone the repository

git clone https://github.com/nolanselby/stackmap.git
cd ai-tool-roadmapper

Tool Database

This project is built on a manually curated database of AI tools.

Accessing the Data

  • Structured Schema: The Postgres schema for all tools, pricing, and capabilities is located in packages/db/src/schema.ts.
  • Seeding: You can populate your own instance using node scripts/apply-seed.mjs.
  • Enrichment Logic: The logic for how tools are classified and scored is open-source in services/enrich and packages/scoring.

Contributing Tools

If you'd like to add a tool to the database, please submit a PR with the tool data added to the seed file.

2. Install dependencies

pnpm install

3. Configure environment variables

cp apps/web/.env.local.example apps/web/.env.local

Open apps/web/.env.local and fill in your keys. See Environment Variables below.

4. Set up Supabase

Follow the step-by-step guide in docs/setup-supabase.md to:

  • Create a Supabase project
  • Enable the pgvector extension
  • Run the database migrations
  • Copy your connection strings into .env.local

5. Run the development server

pnpm dev

The app will be available at http://localhost:3000.

To run all services in parallel with Turborepo:

pnpm dev:all

Project Structure

ai-tool-roadmapper/
├── apps/
│ └── web/ # Next.js 14 application
│ ├── app/ # App Router pages and API routes
│ ├── components/ # React components (chat, roadmap)
│ └── inngest/ # Inngest function definitions
├── packages/
│ ├── db/ # Drizzle ORM schema and Supabase client
│ │ └── supabase/migrations/ # SQL migration files
│ ├── prompts/ # Shared Claude prompt templates
│ ├── schemas/ # Shared Zod validation schemas
│ └── scoring/ # Tool scoring and ranking algorithms
├── services/
│ ├── enrich/ # Tool enrichment (classify, deduplicate)
│ └── planner/ # Roadmap generation and retrieval
├── scripts/ # Utility scripts (seeding, etc.)
├── docs/ # Additional documentation
├── package.json # Root workspace manifest
├── pnpm-workspace.yaml # pnpm workspace configuration
└── turbo.json # Turborepo pipeline configuration

Environment Variables

All required environment variables are documented in apps/web/.env.local.example.

VariableRequiredDescription
ANTHROPIC_API_KEYYesYour Anthropic API key
NEXT_PUBLIC_SUPABASE_URLYesYour Supabase project URL
NEXT_PUBLIC_SUPABASE_ANON_KEYYesSupabase anonymous (public) key
SUPABASE_SERVICE_ROLE_KEYYesSupabase service role key (server-only)
DATABASE_URLYesPostgreSQL connection string
INNGEST_EVENT_KEYYesInngest event key
INNGEST_SIGNING_KEYYesInngest signing key
NEXT_PUBLIC_APP_URLNoPublic app URL (defaults to localhost:3000)

Contributing

Contributions are very welcome! Whether you want to fix a bug, improve the docs, add a new AI tool to the database, or propose a new feature — please read CONTRIBUTING.md first.


License

This project is licensed under the MIT License. See LICENSE for details.


Acknowledgements

  • Anthropic for Claude and the AI SDK
  • Supabase for the database and pgvector support
  • Inngest for background job orchestration
  • React Flow for the interactive graph visualization

About

From idea to AI tool stack in minutes. Describe what you're building — get a complete, opinionated AI tool stack with costs, alternatives, and a build roadmap.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages