How-to guides

Step-by-step guides for common development tasks.

Creating a new Evolve project - Fork the platform and set up a clean project repository
Contributing to Evolve - Backlog, development workflow, and submission checklist

Creating a new domain service - The three-file pattern, GraphQL modules, and gateway registration
Adding a new CMS - Integrate a new CMS end to end, with Sanity as a worked example
Adding a search engine - Create an implementation package for a different search engine
Integrating an external pricing engine - Add an external price source as a federated subgraph
Adding a payment provider - Standalone Fastify service, webhook verification, and state transitions
Adding a custom event and handler - Zod schemas, publishing, cloud handlers, and local testing
Customizing email templates - Add a new transactional email notification end to end
Configuring Datadog with OpenTelemetry - OTel Collector exporter, API keys, and verification

Adding a field to the checkout - Schema, form component, Zod validation, and cart mutation
Adding a language to the storefront - next-intl, translations, store config, and CMS localization
Adding a custom facet component - Custom visual facet variant (e.g. color swatches) for product listing filters
Adding a CMS content block - New block type end to end: schema, mapper, and React component