Skip to content

Add macOS-first first-run onboarding and provider setup #65

Closed

Description

@triggeredcode

Goal

Help a new user reach a working first diagram without having to discover provider setup or core controls on their own.

Scope

  • Show a concise first-run welcome flow on macOS
  • Explain the basic Lucid workflow, then guide provider setup
  • Offer clear paths for LM Studio, Ollama, and OpenAI-compatible/cloud providers
  • Show where API keys are saved and check whether a local provider is reachable
  • Use restrained setup progress and transition animation, with reduced-motion support
  • Finish with a small guided tour of the first useful actions
  • Let users skip the flow and reopen it later from Settings

Boundaries

  • Do not install or launch third-party model software silently
  • Do not require an AI provider to use non-AI parts of Lucid
  • Keep provider secrets in the existing secure credential path
  • Build the flow so later Windows/Linux adaptation is straightforward

Acceptance criteria

  • First launch has an accessible, keyboard-usable onboarding flow
  • Provider setup reuses existing settings and connection checks
  • Completion/skip state persists
  • The flow can be reopened
  • Focused tests cover first-run visibility, persistence, and provider handoff
  • Existing app behavior remains unchanged for returning users

Activity

  1. triggeredcode commented on Oct 20, 2026

    @triggeredcode
    OwnerAuthor

    Claimed. I’m starting with the first-run state and provider handoff, then I’ll add the short guided tour and verify the complete flow before opening the PR.

  2. triggeredcode commented on Oct 20, 2026

    @triggeredcode
    OwnerAuthor

    Implemented in #66. The PR adds the first-run setup flow, provider guidance, workspace coach marks, local completion state, Settings re-entry, reduced-motion handling, and focused unit/Electron coverage. Validation details—including the exact-base comparison for two existing layout-test failures—are recorded in the PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions