> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.makeswift.com/developer/docs/guides/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.makeswift.com/_mcp/server.

# Guides

> Documentation for Makeswift — the composable visual page builder for marketing teams and developers

## Docs

- [Building a Card Component in Makeswift](https://docs.makeswift.com/developer/docs/guides/building-components/card.md): Learn how to create a built-in card component that integrates with Makeswift.
- [Building an Accordion Component in Makeswift](https://docs.makeswift.com/developer/docs/guides/building-components/accordion.md): Learn how to create a built-in accordion component that integrates with Makeswift.
- [App Router](https://docs.makeswift.com/developer/docs/guides/localization/app-router.md): This guide walks you through setting up localization for your Makeswift site so you can visually customize your site for different locales.
- [Pages Router](https://docs.makeswift.com/developer/docs/guides/localization/pages-router.md): This guide walks you through setting up localization for your Makeswift site so you can visually customize your site for different locales.
- [Overview](https://docs.makeswift.com/developer/docs/guides/deploying/overview.md): Learn how to deploy your Makeswift application.
- [Vercel](https://docs.makeswift.com/developer/docs/guides/deploying/vercel.md): Learn how to deploy your Makeswift application to Vercel.
- [Netlify](https://docs.makeswift.com/developer/docs/guides/deploying/netlify.md): Learn how to deploy your Makeswift application to Netlify.
- [Docker](https://docs.makeswift.com/developer/docs/guides/deploying/docker.md): Learn how to deploy your Makeswift application with Docker.
- [Set cookies](https://docs.makeswift.com/developer/docs/guides/how-to/set-cookies.md): Configuring cookies for use within the Makeswift Visual Builder
- [Add fonts](https://docs.makeswift.com/developer/docs/guides/how-to/add-custom-fonts.md): Add fonts to your Makeswift & Next.js project.
- [Multi-tenancy](https://docs.makeswift.com/developer/docs/guides/how-to/multi-tenancy/overview.md): Serve multiple Makeswift sites from a single Next.js application by mapping tenants to Site API keys.
- [Subdomain-based routing](https://docs.makeswift.com/developer/docs/guides/how-to/multi-tenancy/subdomain-based.md): Route tenants using subdomains in a multi-tenant Makeswift application.
- [Path-based routing](https://docs.makeswift.com/developer/docs/guides/how-to/multi-tenancy/path-based.md): Route tenants using URL path prefixes in a multi-tenant Makeswift application.
- [Sandbox and Production Storefronts](https://docs.makeswift.com/developer/docs/guides/how-to/sandbox-and-production-storefronts.md): Run a sandbox and a production BigCommerce Catalyst storefront, each in its own store, and manage both as separate sites in a single Makeswift workspace.
- [Builder isn't loading](https://docs.makeswift.com/developer/docs/guides/troubleshooting/builder-is-not-loading.md)
- [Builder messages](https://docs.makeswift.com/developer/docs/guides/troubleshooting/builder-messages.md): Troubleshoot common error messages shown in the Makeswift builder
- [Layout shift on initial page load](https://docs.makeswift.com/developer/docs/guides/troubleshooting/layout-shift.md): Learn how to fix a layout shift on initial page load in your app
- [Tailwind styles are being overridden](https://docs.makeswift.com/developer/docs/guides/troubleshooting/tailwind-styles-being-overridden.md): Resolve issues with Tailwind v4 or other @layer-based CSS frameworks being overridden by CSS resets
- [Environments](https://docs.makeswift.com/developer/docs/guides/environments.md)
- [Upgrading to 0.29.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.29.0.md)
- [Upgrading to 0.28.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.28.0.md)
- [Upgrading to 0.27.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.27.0.md)
- [Upgrading to 0.26.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.26.0.md)
- [Upgrading to 0.25.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.25.0.md)
- [Upgrading to 0.24.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.24.0.md)
- [Upgrading to 0.23.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.23.0.md)
- [Upgrading to 0.22.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.22.0.md)
- [Upgrading to 0.21.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.21.0.md)
- [Upgrading to 0.20.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.20.0.md)
- [Upgrading to 0.19.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.19.0.md)
- [Upgrading to 0.18.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.18.0.md)
- [Upgrading to 0.15.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.15.0.md)
- [Upgrading to 0.14.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.14.0.md)
- [Upgrading to 0.13.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.13.0.md)
- [Upgrading to 0.9.0](https://docs.makeswift.com/developer/docs/guides/upgrading/0.9.0.md)