Skip to content

feat(home): redesign the getting started welcome screen - #4659

Open
adrianthedev wants to merge 2 commits into
mainfrom
feature/redesign-getting-started-home
Open

feat(home): redesign the getting started welcome screen#4659
adrianthedev wants to merge 2 commits into
mainfrom
feature/redesign-getting-started-home

Conversation

@adrianthedev

@adrianthedev adrianthedev commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator

What

Redesigns the dev-only /avo home page (app/views/avo/home/index.html.erb) — the first screen a developer lands on after installing Avo. The old page was a stale mission/vision blurb plus a hardcoded feature checklist (duplicate "Menu editor" entries, several long-shipped "coming soon" items) that pushed nothing.

The rewrite is organised around three things: next steps → what you can build → try the add-ons.

Changes

  • Start here — a numbered stepper for the real post-install sequence: create your first resource (keeps the smart ApplicationRecord.descendants detection, now showing a ready command inline), wire up current_user, set up authorization.
  • Copyable commands — shell commands now use Avo's copy-to-clipboard controller (extracted to a reusable _command partial), replacing the off-palette bg-sky-500 chips.
  • Real CTAsui.button (accent primary + ghost) instead of a hardcoded bg-green-700 link.
  • Add-ons push — a scannable two-column hover list with the honest framing that every add-on runs free in development. Corrects a factual slip: Dashboards moved from "core" to "add-ons" (its runtime lives in the avo-dashboards gem).
  • Structure — the five single-purpose partials (_actions, _dashboards, _docs, _filters, _resources) are folded into a single panel.with_card body, styled entirely from scheme-reactive tokens (no hardcoded colors, so light/dark both work).

Notes

  • Dev-only surface: the home controller only renders this in development; other environments redirect to the first resource.
  • Verified visually in the dummy app at /admin (light theme; tokens are scheme-reactive so dark follows automatically).
  • No docs change needed — docs/4.0/index.md already tells the same next-steps + add-ons story; this mirrors its groupings.

Rework the dev-only /avo home page around next steps, core
capabilities, and trying paid add-ons.

- Replace the stale mission/vision blurb and hardcoded feature
  checklist (duplicated entries, long-shipped 'coming soon' items).
- 'Start here' numbered stepper: create a resource, wire up
  current_user, set up authorization.
- Copyable shell commands via the copy-to-clipboard controller
  (new reusable _command partial), replacing off-palette bg-sky-500
  chips.
- Real ui.button CTAs (accent primary) instead of a hardcoded
  bg-green-700 link.
- Add-ons section as hover rows; dashboards moved from core to
  add-ons to match its actual gem packaging.
- Fold the five single-purpose partials into one card body
  (panel.with_card), styled entirely from scheme-reactive tokens.

Remove _actions/_dashboards/_docs/_filters/_resources partials.
@github-actions

Copy link
Copy Markdown
Contributor
1 Error
🚫

app/views/avo/home/_command.html.erb:3 Use text-start-* instead of text-left-*

class="group w-full flex items-center gap-2 text-left font-mono text-sm bg-secondary hover:bg-tertiar

Generated by 🚫 Danger

<p class="text-sm text-content-secondary">A resource maps one of your models to a full set of screens — list, show, create, and edit. Point Avo at a model and it builds the interface around it.</p>

<%
models = begin

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

reported by reviewdog 🐶
Layout/LeadingEmptyLines: Unnecessary blank line at the beginning of the source.

<div class="font-medium text-content">Create your first resource</div>
<p class="text-sm text-content-secondary">A resource maps one of your models to a full set of screens — list, show, create, and edit. Point Avo at a model and it builds the interface around it.</p>

<%

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

reported by reviewdog 🐶
Layout/TrailingWhitespace: Trailing whitespace detected.

</div>

<%
addons = [

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

reported by reviewdog 🐶
Layout/LeadingEmptyLines: Unnecessary blank line at the beginning of the source.

<p class="text-sm text-content-secondary">The core manages records. Add-ons take Avo the rest of the way — each is a gem you drop in when the need shows up. <span class="text-content font-medium">Every add-on runs free in development</span>, so you can install one, try it locally, and only need a license when you deploy.</p>
</div>

<%

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

reported by reviewdog 🐶
Layout/TrailingWhitespace: Trailing whitespace detected.

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants