Marketplace Starter Kit

Onboarding

1. Overview

The onboarding flow ensures that new Users are properly authenticated and transitioned into a logged-in experience when they attempt core marketplace actions.

It supports both intentional signup and contextual onboarding, making the platform accessible to visitors while strategically prompting for account creation only when necessary.


2. Visual References

Sign-up and Log-In Modals

Reset Password Page


3. User Experience

3.1 Paths to Signup

For simplicity, we implement a signup/signin modal that appears on top of their current page where authentication flow is triggered. The modal closes once authentication is complete.

Let Users explore as much of the platform as possible before asking for signup. Prompt at the moment of commitment — not curiosity.

Intentional Signup

  • Triggered when a visitor clicks the “Sign Up” button from the header navigation or landing page.
  • They are immediately presented with a modal containing authentication options.

Contextual Onboarding

  • Users can freely browse and filter listings as guests, including using:
    • The Hero search bar
    • Filters like date, category, location
    • Listing detail views
  • When the User attempts a core transactional action such as clicking “Message Host” and “Request to Book” buttons, a modal appears where the User is prompted to sign up or log in before continuing.
  • This approach ensures a frictionless discovery experience while capturing signups at moments of intent.

Modular by design

The codebase is structured in a modular, component-based way—making it easy for your team to modify, replace, or extend individual flows to fit your unique marketplace model. Whether you’re adjusting pricing logic, onboarding steps, or messaging behavior, customization is straightforward and isolated.

3.2 Authentication Methods

  • Multiple authentication providers are offered via Supabase Auth:
    • Email and password
    • Google
    • Apple
    • Facebook
    • GitHub