03-app-structure/00-overview.md

App structure overview

App structure overview

This section defines the standard structure for Vroq apps.

The goal is to make new apps and existing apps follow a consistent layout so ChatGPT and humans can quickly understand where code belongs.

Main goals

A good Vroq app structure should make it easy to:

• find the file that owns a behavior
• understand app bootstrap quickly
• keep feature logic grouped together
• separate shared code from feature-specific code
• keep store setup predictable
• keep new files justified and consistent

Main rule

Use one standard app structure unless there is a strong reason not to.

Consistency is more valuable than inventing a different layout for each app.

What this section covers

This section documents:

• app bootstrap
• index.html
• App.js
• feature folders
• shared code
• store setup
• initial state
• components vs features vs sections
• when to create a new file

Read next

Read these files next:

• 01-bootstrap.md
• 02-index-html.md
• 03-app-js.md
• 04-feature-folders.md
• 05-shared-code.md
• 06-store-setup.md
• 07-initial-state.md
• 08-components-vs-features-vs-sections.md
• 09-when-to-create-a-new-file.md