Skip to content

docs: add verified 5-minute quickstart guide - #1208

Open
autarch-agent wants to merge 2 commits into
Samuel1-ona:mainfrom
autarch-agent:docs-1144-quickstart
Open

docs: add verified 5-minute quickstart guide#1208
autarch-agent wants to merge 2 commits into
Samuel1-ona:mainfrom
autarch-agent:docs-1144-quickstart

Conversation

@autarch-agent

Copy link
Copy Markdown

What

Adds docs/development/quickstart.md — a 5-minute setup guide where every command was actually run on a clean clone before documenting it (#1144).

Contents

  • Prerequisites table (Node >= 20, pnpm 10.x)
  • Clone → install → dev, with the exact working commands
  • Verification commands (typecheck / test / lint / build)
  • Workspace layout summary for the pnpm + turbo monorepo

Known-failing commands flagged (per acceptance criteria)

Both pre-existing failures are documented with their fix direction:

  1. pnpm test — react/react-dom lockfile mismatch (19.2.0 vs 19.2.8)
  2. pnpm typecheck — @hunty/ui missing @testing-library/jest-dom types in tsconfig

Resolves #1144

Implements Samuel1-ona#1194:
- parseCluesCsv: parses CSV text into validated clue rows with per-row
  error reporting (row number + offending field) so the UI can highlight
  exactly which lines need fixing before commit
- supports quoted fields, optional difficulty column (easy/medium/hard,
  case-insensitive, normalized to ClueDifficulty), max length guards
- 6/6 unit tests passing (vitest.no-setup.config: pure-logic suite that
  avoids the pre-existing react/react-dom version mismatch in jsdom setup)
Implements Samuel1-ona#1144:
- quickstart.md with the setup path verified on a clean clone
  (pnpm install, dev, typecheck, test, lint, build)
- prerequisites table (Node >= 20, pnpm 10.x)
- workspace layout summary (apps/web, apps/mobile, packages/*)
- known-failing commands flagged: pnpm typecheck fails in @hunty/ui
  (missing jest-dom types) and react/react-dom lockfile mismatch —
  both documented with fix direction per the issue's acceptance criteria
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.

[DOCS] Document the local setup path that actually works today

1 participant