Axolotl

GraphQL Development Built for the AI Era

From the GraphQL Editor (opens in a new tab) and Aexol Studio (opens in a new tab) teams, comes a type-safe, schema-first GraphQL framework that works seamlessly with AI coding assistants. Write schemas, get perfect types—instantly.

NPM VersionNPM VersionNPM VersionJSR Version

Why Axolotl?

Axolotl eliminates the friction between your GraphQL schema and TypeScript types. No more manual type definitions, no more casting, no more guessing. Your schema is the source of truth, and everything else just works.


AI-Native Development

Works flawlessly with GitHub Copilot, Cursor, ChatGPT, and Claude. AI assistants understand Axolotl's clear patterns and generate perfect, type-safe code every time.

Zero Type Guessing

Generate TypeScript types directly from your schema. AI tools get perfect type hints, your editor autocompletes everything, and TypeScript catches errors before runtime.

Instant Productivity

From schema to production-ready API in minutes. No boilerplate, no setup hell, just pure productivity.

Production-Ready

Battle-tested by teams at GraphQL Editor and Aexol Studio. Ships with everything you need: adapters, micro-federation, DataLoaders, and deployment guides.


Key Features

  • Automatic type generation - Never write GraphQL types by hand again
  • Schema-first workflow - Your GraphQL schema is the single source of truth
  • Full type safety - Catch errors at compile time, not runtime
  • GraphQL Yoga adapter - Production-ready server out of the box
  • Micro-federation - Compose multiple schemas into one supergraph
  • Deno support - Works seamlessly with both Node.js and Deno
  • Custom adapters - Write your own adapter for any GraphQL server
  • Easy setup - Get started with npx @aexol/axolotl create-yoga

Quick Start

# Create a new project
npx @aexol/axolotl create-yoga my-api
 
# Navigate to project
cd my-api
 
# Install dependencies
npm install
 
# Start development server
npm run dev

Your type-safe GraphQL API is now running at http://localhost:4000 🚀

Get Started → | See Examples → | AI Guide →


The Axolotl Advantage

Schema-First = AI-First

# Write your schema
type Query {
  user(id: ID!): User @resolver
}
 
type User {
  id: ID!
  name: String!
  email: String!
}
// Get perfect types automatically
export default createResolvers({
  Query: {
    user: async ([, , ctx], { id }) => {
      // ✅ TypeScript knows everything
      // ✅ AI assistants generate perfect code
      // ✅ No casting, no guessing
      return db.users.findById(id);
    },
  },
});

Why Schema-First Matters in 2025

Clear Contracts - Your API shape is explicit and documented
Better Collaboration - Frontend and backend teams work from the same source of truth
AI-Friendly - AI tools understand schemas better than code-first approaches
Type Safety - One schema generates types for both server and client
Future-Proof - Schema evolution is explicit and trackable


How It Works

Axolotl provides full type safety while letting you choose the adapter (or write your own). You develop your GraphQL API quickly, and the adapter handles runtime details for your chosen server.

The workflow is simple:

  1. Write your schema - Define your GraphQL API in .graphql files
  2. Generate types - Run axolotl build to create TypeScript types
  3. Write resolvers - Implement type-safe resolvers with full autocomplete
  4. Deploy - Use built-in adapters or create your own

Learn more about the architecture →


Community & Support


Contributing

This is an npm workspaces monorepo. To contribute:

# Install dependencies
npm install
 
# Build all workspaces
npm run build --ws --if-present
 
# Run an example
npm run start -w examples/yoga-federated

See Development for detailed contribution guidelines.

Getting Started
Aexol