Creating your first project

Launching your first project in Crystallize is about combining structured product data with a modern storefront and the right operational setup. Below is a step-by-step guide to help you go from a fresh tenant to a production-ready commerce experience.

1. Configure Your Tenant

Set up the basics for your Crystallize tenant to match your business needs.

  • Define languages for product information and content.
  • Create price variants for currencies, markets, or customer-specific pricing.
  • Configure stock locations if you plan to manage inventory.

2. Model Your Product Universe

Decide how your products should be structured.

  • Use Shapes to define product types and attributes.
  • Model rich product data with images, documents, and specifications.
  • For a faster start, use one of our Accelerators (prebuilt data models + storefronts) and customize from there.

3. Create and Organize Product Data

Add products to bring your catalog to life.

  • Manually create products in the Crystallize App.
  • Organize them with folders, topics and grids for navigation and merchandising.
  • If you already have a catalog, import data using our APIs or CLI tools.

4. Build Your Storefront

Connect your catalog to a frontend that delivers the shopping experience.

  • Start from scratch with your favorite frontend framework (React, Next.js, Remix, etc.).
  • Or use a Crystallize Accelerator as a head start (e.g. Product Storytelling, Configurator, Subscription Commerce).
  • Implement key flows: product listing, product detail, cart, and checkout.

5. Connect Integrations

Integrate Crystallize with the rest of your stack.

  • Payments: connect a provider like Stripe, Klarna, Vipps, or others.
  • CRM: sync customer and order data for marketing and support.
  • ERP / warehouse: push orders to your fulfillment system.
  • Email & notifications: trigger transactional and marketing emails.

6. Set Up Permissions and Invite Your Team

Make sure your team can collaborate safely.

  • Create roles and permissions for admins, editors, developers, and external partners.
  • Invite users to your tenant.
  • Configure API keys with the right scopes for storefront and integrations.

7. Test, Optimize, and Go Live

Before going live, ensure everything is working under real-world conditions.

  • QA testing: verify storefront functionality, checkout, and order flows.
  • Performance testing: use load testing tools (like k6) to simulate traffic spikes.
  • Frontend best practices: test Lighthouse scores for performance, accessibility, and SEO.
  • Monitoring: set up logging and analytics to track customer behavior and system health.

8. Launch and Iterate

Commerce projects are never “done.” Once you launch:

  • Monitor sales and funnel insights in Crystallize.
  • Continuously enrich your catalog with better content and media.
  • Add new integrations as your business grows.
  • Iterate on design and performance based on customer feedback.