Skip to content
EvolveEvolveEvolve

Framework packages

Every @evolve-framework/* package from the framework itself, generated from the published versions; the optional ones are under Contrib packages. A service is core's application with modules composed into it: one commerce engine, and the CMS, search, and payment packages the project uses.

Foundation

The application, module system, configuration, and GraphQL schema every service is built on.

cliThe evolve command-line tool.
configA service's configuration as a typed class.
coreThe runtime every Evolve service is built on: the application and its module system, the GraphQL and HTTP server, caching, an HTTP client, logging, tracing and metrics, and the ports for messaging and file storage.
schemasThe contract every Evolve backend speaks.

Commerce engines

One package per engine, each serving the same GraphQL contract.

commercetoolsThe commercetools engine for Evolve: modules that serve the shared GraphQL contract from a commercetools project, from the catalog, cart and checkout to orders, payments, customers, business units, quotes, order approvals, shopping lists and invoices.
medusaThe Medusa v2 engine for Evolve: modules that serve the same GraphQL contract as @evolve-framework/commercetools from Medusa's Store API, so a storefront cannot tell which engine is behind the graph.
sfccThe Salesforce Commerce Cloud (B2C Commerce) engine for Evolve: modules that serve the shared GraphQL contract from the Shopper APIs of an SFCC site.

Payments

Payment providers for the commercetools engine.

commercetools-adyenAdyen payments for the commercetools engine: a payment adapter that lists Adyen's payment methods, starts payments, and processes the shopper's return and Adyen's webhooks, recording each on the commercetools payment.
commercetools-buckarooBuckaroo payments for the commercetools engine: a payment adapter that lists Buckaroo's payment methods, starts payments, and processes the shopper's return and Buckaroo's webhooks, recording each on the commercetools payment.
commercetools-mollieMollie payments for the commercetools engine: a payment adapter that lists Mollie's payment methods, starts payments, and processes the shopper's return and Mollie's webhooks, recording each on the commercetools payment.
commercetools-pay-on-accountPay on account for the commercetools engine: a payment adapter that lets a business unit pay by invoice.
commercetools-paynlPay.nl payments for the commercetools engine: a payment adapter that lists Pay.nl's payment methods, starts payments, and processes the shopper's return and Pay.nl's webhooks, recording each on the commercetools payment.
commercetools-stripeStripe payments for the commercetools engine: a payment adapter that lists Stripe's payment methods, starts payments, and processes the shopper's return and Stripe's webhooks, recording each on the commercetools payment.

CMS

One package per content system, all serving the same content contract.

contentfulThe Contentful CMS for Evolve: a module that serves the shared content contract (pages, content blocks, menus and the site) from a Contentful space, so a storefront reads content the same way whichever CMS is behind it.
payloadThe Payload CMS for Evolve: a plugin that sets up your Payload config with the pages, media and content blocks of the shared content contract, and a module that serves that contract from the same database.
storyblokThe Storyblok CMS for Evolve: a module that serves the shared content contract (pages, content blocks, navigation and site layout) from a Storyblok space, so a storefront reads content the same way whichever CMS is behind it.

The search ports and one package per search provider.

searchThe provider-neutral part of Evolve search.
search-algoliaAlgolia as the search provider for an Evolve shop.
search-meilisearchMeilisearch as the search provider for an Evolve shop.

Cloud

Storage and messaging for each cloud, behind the ports in core.

cloud-adapter-awsRuns Evolve services on AWS.
cloud-adapter-azureRuns Evolve services on Azure.
cloud-adapter-gcpRuns Evolve services on Google Cloud.

Services

Ready-made services and the tools to build and package them.

json-schema-to-zodTurns the JSON Schemas of Evolve's events and notifications into TypeScript: a Zod validator and a matching type for each one, written to a single generated file.
mcp-coreThe building blocks for an MCP (Model Context Protocol) server that exposes a storefront's GraphQL operations as tools for AI assistants, over HTTP or stdio, with customers signing in through OAuth on the storefront's own login page.
packagerBuilds a service into what a cloud deploys: a bundle for a Docker image, a zip for an AWS Lambda, a zip for an Azure Function app, or a zip of its Terraform.
sitemapBuilds a shop's XML sitemaps: it reads every product, category or page from a source, splits them into files of at most 50,000 URLs, and writes the files and their index to file storage.
user-notificationsThe messages Evolve sends when a customer should be told something: an account was created, an order was confirmed or shipped, a password reset was requested or completed, an associate was invited, a quote was requested or is ready.

Integrations

Address lookup and VAT number checks from services outside Evolve, for the modules that ask for them.

loqateA GraphQL module for type-ahead address entry through Loqate's Capture service, in the countries you configure.
pdokGraphQL modules that fill in Dutch addresses from PDOK's Locatieserver, the government's free address search over the BAG register.
photonA GraphQL module for type-ahead address entry through Photon, the open-source geocoder over OpenStreetMap, in the countries you configure.
viesA GraphQL module that checks an EU VAT number live against VIES, the European Commission's VAT information exchange service.