Skip to content

feat(apps): add onboarding ledger and Getting Started #3034

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
riderx merged 23 commits into from
Aug 13, 2026
Merged

feat(apps): add onboarding ledger and Getting Started #3034

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
c4ee94c
feat(apps): add onboarding progress ledger
riderx Aug 13, 2026
53368b4
docs: add onboarding next-step screenshot
riderx Aug 13, 2026
8a7ae0b
ci: retrigger pull_request test suite
riderx Aug 13, 2026
b9edf2a
ci: start tests after marking PR ready
riderx Aug 13, 2026
04eca17
ci: run push tests while PR is closed
riderx Aug 13, 2026
45662d5
fix: drop unused onboarding helper exports
riderx Aug 13, 2026
4a270b0
fix: refresh read-replica schema for apps.onboarding
riderx Aug 13, 2026
0f73823
fix: satisfy sonar reliability on onboarding helper
riderx Aug 13, 2026
cda3e3b
fix: address cubic review on onboarding ledger
riderx Aug 13, 2026
a2d05f6
merge origin/main into feat/app-onboarding-progress
riderx Aug 13, 2026
4109a10
feat(frontend): move onboarding banners into Getting Started
riderx Aug 13, 2026
2ac3157
docs: add Getting Started screenshots for the PR
riderx Aug 13, 2026
583390b
fix(frontend): drop app tabs on Getting Started
riderx Aug 13, 2026
9590bc9
fix(frontend): dedupe Getting Started step lists
riderx Aug 13, 2026
1e46d23
fix(frontend): collapse duplicated Getting Started steps
riderx Aug 13, 2026
d48e4b7
fix(apps): protect onboarding ledger and land Getting Started after w…
riderx Aug 13, 2026
95ed2cd
fix(apps): block forged onboarding on insert and keep RPC patches
riderx Aug 13, 2026
bd9907c
fix(apps): fail insert-protection test when the row is missing
riderx Aug 13, 2026
5da2172
fix(apps): include insert error details in onboarding protection test
riderx Aug 13, 2026
06276ba
merge(main): resolve Getting Started redirect with dashboard app cache
riderx Aug 13, 2026
41326a4
fix(apps): pass onboarding refresh batch size and drop stale cache wr…
riderx Aug 13, 2026
946de7d
fix(apps): include onboarding refresh index in replica schema snapshot
riderx Aug 13, 2026
05a677a
fix(apps): note cron batch_size is unused for function tasks
riderx Aug 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions cli/src/types/supabase.types.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -335,6 +335,7 @@ export type Database = {
rollout_paused_version_names: string[]
name: string | null
need_onboarding: boolean
onboarding: Json
onboarding_completed_at: string | null
owner_org: string
retention: number
Expand Down Expand Up @@ -367,6 +368,7 @@ export type Database = {
rollout_paused_version_names?: string[]
name?: string | null
need_onboarding?: boolean
onboarding?: Json
onboarding_completed_at?: string | null
owner_org: string
retention?: number
Expand Down Expand Up @@ -399,6 +401,7 @@ export type Database = {
rollout_paused_version_names?: string[]
name?: string | null
need_onboarding?: boolean
onboarding?: Json
onboarding_completed_at?: string | null
owner_org?: string
retention?: number
Expand Down Expand Up @@ -3640,6 +3643,7 @@ export type Database = {
manifest_bundle_count: number
name: string | null
need_onboarding: boolean
onboarding: Json
onboarding_completed_at: string | null
owner_org: string
retention: number
Expand Down Expand Up @@ -4326,6 +4330,10 @@ export type Database = {
Returns: boolean
}
mark_app_stats_refreshed: { Args: { p_app_id: string }; Returns: string }
mark_onboarding_feature_started: {
Args: { p_app_id: string, p_feature_key: string }
Returns: Json
}
mass_edit_queue_messages_cf_ids: {
Args: {
updates: Database["public"]["CompositeTypes"]["message_update"][]
Expand Down
Binary file added docs/pr-assets/app-onboarding-dashboard.webp
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/pr-assets/getting-started-dashboard.webp
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/pr-assets/getting-started-page-dark.webp
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/pr-assets/getting-started-page.webp
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
36 changes: 36 additions & 0 deletions messages/en.context.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -680,7 +680,9 @@
"bundle-not-found-description": "Used in Capgo web console areas: pages/app. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"bundle-number": "Used in Capgo web console areas: components/tables, pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"bundle-to-production-device": "Used in Capgo web console areas: pages/admin/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"bundle-to-store-live": "Used in Capgo web console areas: pages/admin/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"bundle-to-subscribed": "Used in Capgo web console areas: pages/admin/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"bundle-to-testflight": "Used in Capgo web console areas: pages/admin/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"bundle_uploads": "Used in Capgo web console areas: components/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"bundles": "Used in Capgo web console areas: components/tables, constants, layouts, stores. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"bundles-deleted": "Used in Capgo web console areas: components/tables. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
Expand Down Expand Up @@ -1265,6 +1267,13 @@
"disableAutoUpdateToMajor": "Used in Capgo web console areas: pages/app, services, types. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"disabled": "Used in Capgo web console areas: components, components/bundle, components/forms, components/organizations, pages. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"disabled-capgo-updates": "Used in Capgo web console areas: components/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"distribution-stage": "Used in Capgo web console areas: pages/admin/dashboard. Role: table column label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"distribution-stage-local-only": "Used in Capgo web console areas: pages/admin/dashboard. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"distribution-stage-native-unknown": "Used in Capgo web console areas: pages/admin/dashboard. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"distribution-stage-no-device": "Used in Capgo web console areas: pages/admin/dashboard. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"distribution-stage-play-unknown": "Used in Capgo web console areas: pages/admin/dashboard. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"distribution-stage-store-live": "Used in Capgo web console areas: pages/admin/dashboard. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"distribution-stage-testflight": "Used in Capgo web console areas: pages/admin/dashboard. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"discord": "Used in Capgo web console areas: components. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"discord-username": "Used in Capgo web console areas: components/dashboard, pages/settings/account. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"discord-username-help": "Used in Capgo web console areas: components/dashboard, pages/settings/account. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
Expand Down Expand Up @@ -1477,6 +1486,21 @@
"generated-new-apikey": "Used in Capgo web console areas: pages. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"get": "Used in Capgo web console areas: components/dashboard, services, types. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"get-started": "Used in Capgo web console areas: pages. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started": "Used in Capgo web console areas: pages/app, components. Role: section or dialog title. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-action-explore": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-action-setup": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-action-validate": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-complete": "Used in Capgo web console areas: pages/app. Role: UI sentence. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-complete-desc": "Used in Capgo web console areas: pages/app. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-count": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-description": "Used in Capgo web console areas: pages/app. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-dismiss": "Used in Capgo web console areas: components. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-done": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-essential": "Used in Capgo web console areas: pages/app. Role: section or dialog title. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-grow": "Used in Capgo web console areas: pages/app. Role: section or dialog title. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-live-update": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-live-update-desc": "Used in Capgo web console areas: pages/app. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"getting-started-percent": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"github-stars-trend": "Used in Capgo web console. Role: UI label about \"github stars trend\". Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"github-username": "Used in Capgo web console areas: components/dashboard, composables, pages/settings/account. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"github-username-confirm": "Used in Capgo web console areas: components/dashboard. Role: short UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
Expand Down Expand Up @@ -1931,6 +1955,14 @@
"onboarding-invite-option-title": "Used in Capgo web console areas: components/dashboard. Role: section or dialog title. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-manual-setup-link": "Used in Capgo web console areas: components/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-manual-setup-prefix": "Used in Capgo web console areas: components/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-next-builder": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-next-builder-desc": "Used in Capgo web console areas: pages/app. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-next-cli-install": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-next-cli-install-desc": "Used in Capgo web console areas: pages/app. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-next-ota-device": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-next-ota-device-desc": "Used in Capgo web console areas: pages/app. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-next-ota-store": "Used in Capgo web console areas: pages/app. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-next-ota-store-desc": "Used in Capgo web console areas: pages/app. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-prerequisites-built": "Used in Capgo web console areas: components/dashboard. Role: UI sentence. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-prerequisites-capacitor": "Used in Capgo web console areas: components/dashboard. Role: UI sentence. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"onboarding-prerequisites-cli-desc": "Used in Capgo web console areas: components/dashboard. Role: helper or description text. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
Expand Down Expand Up @@ -2285,6 +2317,10 @@
"rbac-system-enabled-body": "Used in Capgo web console. Role: UI sentence about \"rbac system enabled body\". Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"read-the-documentation": "Used in Capgo web console. Role: UI label about \"read the documentation\". Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"read-value": "Used in Capgo web console areas: pages. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"reached-app-store-live": "Used in Capgo web console areas: pages/admin/dashboard. Role: current App Store live count among orgs that uploaded a bundle in 7 days, not a sequential funnel step. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"reached-app-store-live-within-7-days": "Used in Capgo web console areas: pages/admin/dashboard. Role: trend of current App Store live among that signup day's 7-day bundle orgs. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"reached-testflight": "Used in Capgo web console areas: pages/admin/dashboard. Role: current TestFlight-only count among orgs that uploaded a bundle in 7 days, parallel to App Store live. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"reached-testflight-within-7-days": "Used in Capgo web console areas: pages/admin/dashboard. Role: trend of current TestFlight-only among that signup day's 7-day bundle orgs. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"reason-optional": "Used in Capgo web console areas: components/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"reason-placeholder": "Used in Capgo web console areas: components/dashboard. Role: input placeholder. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
"recent-releases-active": "Used in Capgo web console areas: components/dashboard. Role: UI label. Translate for UI; keep Capgo product names, code, and placeholders unchanged.",
Expand Down
40 changes: 38 additions & 2 deletions messages/en.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -270,11 +270,47 @@
"admin-debug-trigger-toast": "Run replication toast simulation",
"activation-telemetry-unavailable": "Activation telemetry is unavailable for this date range. Select a range within the last 3 months.",
"bundle-to-production-device": "Bundle → Production device",
"bundle-to-testflight": "Bundle → TestFlight",
"bundle-to-store-live": "Bundle → App Store live",
"completed-update-download": "Completed update download",
"completed-update-download-within-7-days": "Completed Update Download (within 7 days)",
"completed-update-download-within-7-days": "Completed update download (within 7 days)",
"production-device-to-update-download": "Production device → Update download",
"production-plugin-device": "Production plugin device",
"production-plugin-device-within-7-days": "Production Plugin Device (within 7 days)",
"production-plugin-device-within-7-days": "Production plugin device (within 7 days)",
"reached-testflight": "Currently TestFlight",
"reached-testflight-within-7-days": "Currently TestFlight (7-day bundle orgs)",
"reached-app-store-live": "Currently App Store live",
"reached-app-store-live-within-7-days": "Currently App Store live (7-day bundle orgs)",
"distribution-stage": "Distribution",
"distribution-stage-no-device": "No device",
"distribution-stage-local-only": "Local only",
"distribution-stage-native-unknown": "Native unknown",
"distribution-stage-play-unknown": "Play (track unknown)",
"distribution-stage-testflight": "TestFlight",
"distribution-stage-store-live": "App Store live",
"onboarding-next-cli-install": "Install Capgo on a device",
"onboarding-next-cli-install-desc": "Run the CLI install command, then open the app so Capgo can see a real device.",
"onboarding-next-ota-device": "Open the app on a device",
"onboarding-next-ota-device-desc": "Capgo has not seen a TestFlight or store install yet. Launch the app from TestFlight or a store build.",
"onboarding-next-ota-store": "Ship a live store build",
"onboarding-next-ota-store-desc": "Devices are on TestFlight or an unknown store track. A live App Store install is the next proof point.",
"onboarding-next-builder": "Finish your first native build",
"onboarding-next-builder-desc": "A native build was started but has not succeeded yet. Complete it to keep going.",
"getting-started": "Getting started",
"getting-started-description": "Complete these steps to launch live updates for this app.",
"getting-started-count": "{done} of {total}",
"getting-started-percent": "{percent}%",
"getting-started-essential": "Essential setup",
"getting-started-grow": "Grow your app",
"getting-started-done": "Done",
"getting-started-action-setup": "Set up",
"getting-started-action-validate": "Validate",
"getting-started-action-explore": "Explore",
"getting-started-dismiss": "Hide getting started",
"getting-started-complete": "Live Update is set up",
"getting-started-complete-desc": "You can keep using this checklist for production checks and Builder.",
"getting-started-live-update": "Ship a live update",
"getting-started-live-update-desc": "Upload a bundle so devices can receive an over-the-air update.",
"all-billing-cycles": "All billing cycles",
"all-bundles": "All bundles",
"all-plans": "All plans",
Expand Down
Loading
Loading