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 - Development workflow and submission checklist for your project

Creating a new domain service - The four-file pattern (config, module, server, entry point), framework modules, and supergraph composition
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 - Framework package with payment adapter and module, mounted by a thin platform service
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

Local HTTPS with Portless - Stable *.evolve.localhost hostnames with system-trusted certs for OAuth callbacks, secure cookies, and cross-subdomain editor sessions