Skip to content

Docs: Add project structure page#5133

Open
symball wants to merge 1 commit intowailsapp:masterfrom
symball:docs_project_structure
Open

Docs: Add project structure page#5133
symball wants to merge 1 commit intowailsapp:masterfrom
symball:docs_project_structure

Conversation

@symball
Copy link
Copy Markdown
Contributor

@symball symball commented Apr 12, 2026

Add missing Project Structure docs page

Summary by CodeRabbit

  • Documentation
    • Added a "Project Structure" guide describing the typical directory and file layout for a Wails project, covering frontend stack (Vite + React + TypeScript), backend configuration, dev tooling, and build/packaging assets; notes on variation with other starter templates.
  • Chores
    • Updated unreleased changelog to list the new project structure page.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 12, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 43409e37-8a63-4736-8a76-797071d858ef

📥 Commits

Reviewing files that changed from the base of the PR and between f564ece and 45255e7.

📒 Files selected for processing (2)
  • docs/src/content/docs/guides/dev/project-structure.mdx
  • v3/UNRELEASED_CHANGELOG.md
✅ Files skipped from review due to trivial changes (2)
  • docs/src/content/docs/guides/dev/project-structure.mdx
  • v3/UNRELEASED_CHANGELOG.md

Walkthrough

A new documentation guide page docs/src/content/docs/guides/dev/project-structure.mdx was added describing the typical directory and file layout of a Wails Vanilla template project; the changelog v3/UNRELEASED_CHANGELOG.md was updated to list the addition.

Changes

Cohort / File(s) Summary
Project Structure Documentation
docs/src/content/docs/guides/dev/project-structure.mdx
Added a new guide page with frontmatter and a rendered tree describing Go backend files, module/config, Taskfile tooling, build/packaging assets, and frontend (Vite+React+TS) layout; notes that frontend/src varies by starter template.
Changelog
v3/UNRELEASED_CHANGELOG.md
Enabled an "Added" changelog entry: "Added missing project structure page." (replaced placeholder comment).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested labels

Documentation

Suggested reviewers

  • leaanthony

Poem

🐰 A tidy tree of folders grown,

Go and frontend seeds are sown,
Pages list where secrets hide,
Developers hop in with pride,
✨📁

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description is incomplete; it lacks issue reference, detailed summary, type of change selection, testing information, and most required checklist items. Add issue reference (Fixes #), complete type of change selection, include testing details, and fill out the required checklist items including changelog update.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely summarizes the main change: adding a project structure documentation page.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
docs/src/content/docs/guides/dev/project-structure.mdx (1)

41-41: Small phrasing tweak for readability.

Consider “the contents of frontend/src will differ…” for cleaner grammar.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/src/content/docs/guides/dev/project-structure.mdx` at line 41, Update
the sentence that currently reads "If you choose to use a different starter
template, contents of `frontend/src` will differ depending on your chosen
framework" to a smoother phrasing such as "If you choose a different starter
template, the contents of `frontend/src` will differ depending on your chosen
framework" (or "the contents of `frontend/src` will differ depending on which
framework you choose"); locate the sentence referencing `frontend/src` and
replace it with the revised wording to improve grammar and readability.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/src/content/docs/guides/dev/project-structure.mdx`:
- Line 8: The doc claims "Vanilla template" but the displayed tree uses
React+TypeScript artifacts; either update the heading text on line 8 to "React +
TypeScript template" or adjust the tree to match the Vanilla template by
replacing TypeScript/React items (vite.config.ts, tsconfig.json, React mention
in the frontend comment) with Vanilla equivalents (vite.config.js, remove
tsconfig.json, change frontend comment to plain JS). Make a single consistent
change so the heading and the listed files (vite.config.ts / vite.config.js,
tsconfig.json, frontend comment) reflect the same template.

---

Nitpick comments:
In `@docs/src/content/docs/guides/dev/project-structure.mdx`:
- Line 41: Update the sentence that currently reads "If you choose to use a
different starter template, contents of `frontend/src` will differ depending on
your chosen framework" to a smoother phrasing such as "If you choose a different
starter template, the contents of `frontend/src` will differ depending on your
chosen framework" (or "the contents of `frontend/src` will differ depending on
which framework you choose"); locate the sentence referencing `frontend/src` and
replace it with the revised wording to improve grammar and readability.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 4f8a779d-85a0-4e7a-9199-f588f4a92329

📥 Commits

Reviewing files that changed from the base of the PR and between bb4fbf9 and f564ece.

📒 Files selected for processing (1)
  • docs/src/content/docs/guides/dev/project-structure.mdx

Comment thread docs/src/content/docs/guides/dev/project-structure.mdx
@leaanthony
Copy link
Copy Markdown
Member

Thanks 🙏 Please could you add an entry to the changelog located at v3/UNRELEASED_CHANGELOG.md? Thanks!

* Rework command initiation to use cobra / viper
* abstract init builder away from command package
@symball symball force-pushed the docs_project_structure branch from f564ece to 45255e7 Compare April 16, 2026 03:19
@symball
Copy link
Copy Markdown
Contributor Author

symball commented Apr 16, 2026

v3/UNRELEASED_CHANGELOG.md updated

@leaanthony leaanthony changed the base branch from v3-alpha to master April 29, 2026 13:08
@leaanthony
Copy link
Copy Markdown
Member

Triaged by Wails PR Reviewer

This PR has been reviewed and accepted.

Head Ref OID: 45255e73aab75f08c0cd34f32e5a1118a30a722f


This comment serves as a signature that this PR has been triaged. Future runs will skip this PR based on the headRefOid.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants