Axolotl

From the GraphQL Editor (opens in a new tab) and Aexol Studio (opens in a new tab) teams, comes a Framework ensuring GraphQL Resolvers and arguments type-safety. Written in TypeScript.

NPM VersionNPM VersionNPM VersionNPM VersionJSR Version

😮 Features

Axolotl is a framework overlord/wrapper thats lets you forget about type-casting and looking into schemas. When there is no drama, only efficiency remains.


  • ⚙️ Generates models at runtime during development - which ensures type safety
  • 🏃 Enables seamless migration between different GraphQL Servers like GraphQL Yoga and Apollo Server
  • 🤓 Lets you write your own adapters for various purposes
  • 🐙 Supports micro-federation! It allows to merge different schemas and resolvers inside one repository.
  • 🦕 Supports Deno from version 0.2.7. It works with Deno in production.
  • 😂 Is very easy to setup, start and integrate. You just need to npx @aexol/axololtl create-yoga
  • 🦎 includes modularium, a package with installable GraphQL schemas with backend

🤔 Story

Writing GraphQL for backend developers remains a complicated process when you want to take the schema-first approach instead of going code-first. I was in the type-safety rabbit hole while building GraphQL Zeus (opens in a new tab) (a GraphQL client with almost 1 million downloads). Maintaining Zeus and developing with the constantly-changing TypeScript proved to be really hard.
Over the years, I have come to understand that there was even more to it: we needed an evolutionary framework. I decided to write something simpler. Something that the community needed that integrated everything using the same knowledge. Something, ultimately, much more powerful.

This is how Axolotl was born.


😇 How?

Axolotl provides type-safety and lets you choose the adapter (or write your own). It allows you to develop your GraphQL project quickly and efficiently. How it runs it also depends on the underlying framework you choose.


Repository

ElementDescription
AdaptersTo develop adapters for popular nodejs frameworks
ExamplesTo experiment with axolotl and its packages
ModulariumInstallable code chunks for your project
Micro-federationTo use the micro-federation feature in axolotl

- Micro-federation means that all the modules are located within one project or one monorepo or are distributed as npm packages
- The axolotl projects are merged to the supergraph later

Development

[!IMPORTANT] To start developing you need to know a few things.


This is an npm workspaces monorepo.


There is a sequential build order for commands as seen below:

 npm run build --ws --if-present

To run an example execute you need to type in:

 npm run start -w beerpub