wails/docs
Lea Anthony 0c88fb217c Improve documentation clarity and reduce cognitive load
- Update Go version requirement from 1.23+ to 1.25+ across all docs
- Update installation.mdx with links to official installers and actual wails3 doctor output
- Revert first-app.mdx to simple greet app tutorial (10 mins)
- Move TODO app to dedicated tutorial at tutorials/todo-vanilla.mdx (20 mins)
- Simplify next-steps.mdx: remove 50+ links, focus on essential paths
- Simplify tutorials/overview.mdx: remove emojis, cards, verbose sections
- Add Windows 11 Dev Drive performance tips to installation guides
- Fix auto-rebuild documentation (Go code auto-rebuilds, no manual restart needed)
- Remove "What You've Learned" section emojis
- Convert cards to bullet points throughout for better readability

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-15 08:42:09 +11:00
..
.vscode [v3] Add starlight website (#3917) 2024-12-08 12:09:13 +11:00
public Improve documentation clarity and reduce cognitive load 2025-11-15 08:42:09 +11:00
src Improve documentation clarity and reduce cognitive load 2025-11-15 08:42:09 +11:00
.gitignore [v3] Add starlight website (#3917) 2024-12-08 12:09:13 +11:00
.npmrc Docs: Add community page(s) (#3941) 2024-12-10 07:53:36 +11:00
astro.config.mjs Improve documentation clarity and reduce cognitive load 2025-11-15 08:42:09 +11:00
build-output.txt docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
bun.lock docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
CNAME Setup starlight workflow 2024-12-08 12:28:50 +11:00
COMPLETE_SUMMARY.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
create-dirs.ps1 docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
DOCUMENTATION_REDESIGN_STATUS.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
DOCUMENTATION_STATUS.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
FINAL_PROJECT_STATUS.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
FINAL_STATUS.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
FINAL_SUMMARY.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
IMPLEMENTATION_SUMMARY.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
NEXT_STEPS.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
package-lock.json Improve documentation clarity and reduce cognitive load 2025-11-15 08:42:09 +11:00
package.json docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
PHASE1_COMPLETE.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
PHASE1_PROGRESS.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
PHASE2_COMPLETE_FINAL.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
PHASE2_COMPLETION.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
PHASE2_PROGRESS.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
PHASE3_PLAN.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
PROGRESS_REPORT.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
PROJECT_HANDOFF.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
README.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
README_DOCUMENTATION.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
REDESIGN_COMPLETE.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
REDESIGN_PROGRESS.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
SESSION_COMPLETE.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00
Taskfile.yml Improve documentation clarity and reduce cognitive load 2025-11-15 08:42:09 +11:00
tsconfig.json [v3] Add starlight website (#3917) 2024-12-08 12:09:13 +11:00
WORK_SUMMARY.md docs: Complete documentation redesign with enhanced landing page 2025-10-04 22:15:35 +10:00

Wails v3 Documentation

Built with Starlight

World-class documentation for Wails v3, redesigned following Netflix documentation principles.

📚 Documentation Redesign (2025-10-01)

This documentation has been completely redesigned to follow the Netflix approach to developer documentation:

  • Problem-first framing - Start with why, not what
  • Progressive disclosure - Multiple entry points for different skill levels
  • Real production examples - No toy code
  • Story-Code-Context pattern - Why → How → When
  • Scannable content - Clear structure, visual aids

Status: Foundation complete (~20%), ready for content migration

See IMPLEMENTATION_SUMMARY.md for full details.

🚀 Project Structure

Inside of your Astro + Starlight project, you'll see the following folders and files:

.
├── public/
├── src/
│   ├── assets/
│   ├── content/
│   │   ├── docs/
│   │   └── config.ts
│   └── env.d.ts
├── astro.config.mjs
├── package.json
└── tsconfig.json

Starlight looks for .md or .mdx files in the src/content/docs/ directory. Each file is exposed as a route based on its file name.

Images can be added to src/assets/ and embedded in Markdown with a relative link.

Static assets, like favicons, can be placed in the public/ directory.

🧞 Commands

All commands are run from the root of the project, from a terminal:

Command Action
npm install Installs dependencies
npm run dev Starts local dev server at localhost:4321
npm run build Build your production site to ./dist/
npm run preview Preview your build locally, before deploying
npm run astro ... Run CLI commands like astro add, astro check
npm run astro -- --help Get help using the Astro CLI

👀 Want to learn more?

Check out Starlights docs, read the Astro documentation, or jump into the Astro Discord server.