Skip to content

Agentic start: copy-prompt button and /start walkthrough - #1189

Draft
gwenwindflower wants to merge 3 commits into
mainfrom
agentic-start
Draft

Agentic start: copy-prompt button and /start walkthrough#1189
gwenwindflower wants to merge 3 commits into
mainfrom
agentic-start

Conversation

@gwenwindflower

Copy link
Copy Markdown
Contributor

Summary

An agent-first onboarding entry point, borrowed with love from Flue's docs:

  • /start walkthrough (start.mdx) — a hidden page written to coding agents, served at docs.lightdash.com/start.md. Choose-your-own-adventure shape: install CLI + agent skills → real project (dbt via Quickstart, or no-dbt via Lightdash YAML) vs sandbox (Supabase quickstart repo today, MotherDuck alternative) → account signup → next steps. Kept out of nav deliberately (hidden: true + seo.indexing: "all" keeps it in llms.txt and the .md export).
  • Copy-prompt button on the homepage (snippets/copy-prompt-button.jsx) — accent-purple pill with Claude Code / Codex / opencode / Cursor icons that lean in on hover; the preview line under the button shows the exact prompt it copies, and on click char-scrambles into a purple success state, then fades back out after a cooloff.
  • Agent context updates (.mintlify/AGENTS.md) — local preview server conventions and the hidden-page pattern.

Review notes

  • Draft until team feedback + a designer pass on the button (all knobs are CSS + three constants in the jsx).
  • mint broken-links and scripts/docs/validate.ts pass.
  • Post-deploy check: confirm https://docs.lightdash.com/start.md serves — hidden pages + markdown export is the one combination Mintlify doesn't explicitly document (works locally at /start; .md export only exists on the hosted platform).
  • The sandbox path is broad strokes by design; a dedicated template repo is marked as a placeholder comment in start.mdx.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Q7j1Lnzqm9WnSwg1zYbrKY

gwenwindflower and others added 3 commits August 26, 2026 21:15
Hidden page fetched as /start.md by coding agents; seo.indexing all
keeps hidden pages in llms.txt and the markdown export.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q7j1Lnzqm9WnSwg1zYbrKY
Copies an agent start prompt pointing at /start.md; four agent brand
icons with hover motion, and a char-scramble preview line that cycles
between the prompt and the copied confirmation.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q7j1Lnzqm9WnSwg1zYbrKY
@mintlify

mintlify Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Aug 27, 2026, 2:17 AM

@github-actions

Copy link
Copy Markdown
Contributor

Documentation validation

✅ All blocking checks passed.

Component system

0 finding(s) across the corpus.

Findings on lines this pull request touched are annotated inline in Files changed.

Download the structured JSON artifact.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant