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.