Repository navigation
feat(site): a setup prompt for coding assistants - #100
Merged
Merged
Conversation
One prompt that users paste into Claude Code, Codex, Cursor or Copilot to add Dotquilt to their project. It works in four phases: 1. Learn Dotquilt from llms-full.txt (raw, not summarised). 2. Analyse the project: stack, rendering, data loading, every place that waits for content, theme and dark mode, CSP, tests and gaps. Report a table of places with proposed placeholders, a plan, and only the questions the code can't answer, then stop for the answers. 3. Implement in order: install, one-time setup (theme, dark mode, CSP), the most-seen place end to end, then one place at a time, mapping the app's existing state to pending, refreshing or ready without touching data code. It covers tables, TextLoader, refresh rows, Next.js, Suspense and native elements for other frameworks. 4. Verify (types, lint, tests, build, each place in the browser, light, dark, reduced motion, server HTML) and report how to undo. It was tested by an agent on a mock Next.js dashboard with seven loading places; two rounds of findings are folded in. On the site: src/prompts/setup.md is the one source for /setup-prompt.md, the docs page /docs/ai-setup/ (in Getting started) and a "Copy setup prompt" button on the home page. llms.txt links it and no longer says "pre-alpha, not on npm". Page Markdown drops page-only <style> blocks and <div> wrappers. Theming explains color-scheme for media-query dark modes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Also records the setup prompt in AUDIT.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A prompt users paste into Claude Code, Codex, Cursor or Copilot to add Dotquilt to their project. It analyses first, asks, then implements in order.
Evidence
Tested on a mock Next.js 16 dashboard. An agent played the user's assistant and got only the prompt. The mock app had seven loading places: a spinner KPI block, a pulse-skeleton chart, a React Query table with paging, a refresh feed, a typing bubble, a profile card and a route
loading.tsx. It also had two button spinners that should be left alone.color-scheme, docs summarised by a web tool, and loading states that never end on failure.aria-labeled header cells instead of a visually hidden<thead>(which drew a stray row of marks), room for the refresh row, matching line heights, andnumbercolumns.Site: 73 site tests pass. New ones check that
/setup-prompt.mdis served, thatllms.txtlinks it with no "not on npm", and that the copy button on/docs/ai-setup/and/puts the exact prompt on the clipboard. The new page also passes the contrast, form-control-name and 320 px checks.Library findings from the test (follow-ups, not in this PR):
ready, which leaves blank space around error messages.--dotquilt-refresh-gapis missing from the React style type.Merge Danger
Door: two-way
Blast Radius: docs site
One new page, one block on the home page, and the
llms.txttext. Merging deploys dotquilt.dev.🤖 Generated with Claude Code