Onboarding & Support

Overview

• Route: /onboarding
• Trigger: Shown immediately after registration (post-signup redirect)
• Steps: 4 sequential steps
• Progress tracking: onboarding_progress table in database
• Completion: Redirects to dashboard when all 4 steps are done

Collects the dealer's business information. All validation uses Zod schemas.

GSTIN Format Breakdown

22AAAAA0000A1Z5
││     │    │││└─ Check digit (alphanumeric)
││     │    ││└── Always "Z"
││     │    │└─── Alphanumeric
││     │    └──── Alpha
││     └─────────  4 digits
│└───────────────  5 uppercase letters (PAN)
└────────────────  2-digit state code

Save Action

• Calls updateDealerProfile to save shop details
• Calls completeStep('shop_details') to mark step complete

Allows the dealer to choose their preferred language. Uses i18next for internationalization.

• Language switch is applied immediately via i18next.changeLanguage()
• Selection persisted to dealer profile
• All UI text updates in real-time on selection

The dealer selects initial products from the global catalog or adds custom products.

Two Methods

What Happens

• Selected products are added to the dealer's product list
• Inventory rows are initialized (stock = 0) for each selected product
• The dealer can add more products later from the Products page

Creates the dealer's first customer (farmer) record.

After this step, the dealer has a complete minimal setup: shop profile, language, products, and at least one customer.

Database: onboarding_progress table

Each step's completion is tracked individually. The dealer can leave and resume onboarding — completed steps are skipped on return.

When all 4 steps are complete, the dealer is redirected to the dashboard. The onboarding route becomes inaccessible (redirects to dashboard if visited again).