feature/onboarding — First-Launch Onboarding

Display a three-slide Flutter onboarding with Hive-persisted seen status.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Vantoan252003/Mozi --skill feature-onboarding-first-launch-onboarding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature/onboarding — First-Launch Onboarding
Source: https://github.com/Vantoan252003/Mozi/tree/main/lib/features/onboarding
Command: npx skills add https://github.com/Vantoan252003/Mozi --skill feature-onboarding-first-launch-onboarding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This feature ensures first-time users receive a concise, guided introduction and prevents the onboarding from showing again by persisting a "has seen" flag, avoiding repeated interruptions and enabling route guards to decide navigation.

Core Features & Use Cases

  • Three-slide Intro: A PageView presenting three OnboardingSlideEntity items, each with a Lottie animation, title, description, and background color.
  • Skip and Complete Flows: A visible "Skip" action on early pages and a "Next"/"Bắt đầu" button on the final page, with CompleteOnboardingUseCase writing the seen flag to Hive.
  • State and Navigation: OnboardingCubit manages currentPage, totalPages, and isLastPage, while the route guard reads the persisted flag to route users to login or main flows.

Quick Start

Open the app on first launch and use OnboardingCubit to navigate pages and call CompleteOnboardingUseCase to persist the seen flag.

Frequently Asked Questions about feature/onboarding — First-Launch Onboarding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I show a Flutter onboarding flow only on first app launch?

To show a Flutter onboarding flow on first launch, display a PageView with intro slides and persist a 'has seen' boolean flag in local Hive storage. A route guard then reads this flag to determine if the user should see the intro or proceed to main flows.

How does Cubit manage page navigation in a Flutter onboarding sequence?

Cubit manages onboarding page navigation by tracking currentPage, totalPages, and isLastPage states. OnboardingCubit handles transitions between slides and triggers the CompleteOnboardingUseCase to write the seen flag to Hive upon finishing.

Can I use Lottie animations in a Flutter PageView for onboarding slides?

Yes, you can use Lottie animations in a Flutter PageView for onboarding slides. Each OnboardingSlideEntity in the PageView supports a Lottie animation alongside its title, description, and background color to create a guided visual introduction.

Do I need Hive to persist the onboarding seen flag in Flutter?

Yes, you need local Hive storage to persist the onboarding seen flag in Flutter. The CompleteOnboardingUseCase writes the boolean flag to Hive, allowing route guards to read it and prevent the onboarding from showing again on subsequent app launches.

What's the best way to handle skip and complete flows in Flutter onboarding?

The best way to handle skip and complete flows in Flutter onboarding is providing a visible Skip action on early pages and a Next or 'Bắt đầu' button on the final page. Completing either flow triggers the use case to write the seen flag to Hive.

When do I need a route guard for Flutter onboarding navigation?

You need a route guard for Flutter onboarding navigation when deciding whether first-time users should see the intro or go directly to login. The guard reads the persisted Hive flag to route users appropriately, avoiding repeated interruptions.