Guided discovery
Guided product discovery through taste preferences
An interactive product discovery tool that helps customers find the right product by asking about their preferences instead of expecting them to browse categories.
Technical narrative
This is where the archive goes deeper than the homepage: architecture choices, operating constraints, and the decisions that make the product maintainable over time.
Liquor and smoke shops carry hundreds of products across dozens of categories. Browsing a flat catalog is overwhelming for customers who do not know exactly what they want. The business needed a way to guide customers toward products they would actually enjoy.
The Flavor Wizard presents a branching questionnaire that narrows down products based on taste profiles, category preferences, and experience level. Each step dynamically filters the catalog, and the final results are ranked by relevance. The wizard supports multiple entry points and adapts its flow based on earlier answers.
The wizard state is managed client-side with React state, while product matching runs against Supabase queries filtered by flavor tags and category metadata. I chose a branching architecture over a linear questionnaire so the experience feels conversational rather than like a survey. Animations use Motion for smooth step transitions.
The business owner can manage flavor tags, adjust product associations, and configure which products appear in wizard results through the admin dashboard. That keeps the recommendation layer useful as the catalog changes without requiring developer intervention.