Skip to content

Commit 8104a41

Browse files
TheOtterlordyanthomasdevsarah11918
authored
Add feature directories to project structure guide (withastro#3237)
Co-authored-by: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com> Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
1 parent 01e441d commit 8104a41

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

src/content/docs/en/core-concepts/project-structure.mdx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,12 +62,20 @@ Astro processes, optimizes, and bundles your `src/` files to create the final we
6262

6363
Some files (like Astro components) are not even sent to the browser as written but are instead rendered to static HTML. Other files (like CSS) are sent to the browser but may be optimized or bundled with other CSS files for performance.
6464

65+
### `src/assets`
66+
67+
The [`src/assets`](/en/guides/assets/) directory is the recommended folder to use for storing assets (e.g. images) that are processed by Astro. This is not required, and this is not a special reserved folder.
68+
6569
### `src/components`
6670

6771
**Components** are reusable units of code for your HTML pages. These could be [Astro components](/en/core-concepts/astro-components/), or [UI framework components](/en/core-concepts/framework-components/) like React or Vue. It is common to group and organize all of your project components together in this folder.
6872

6973
This is a common convention in Astro projects, but it is not required. Feel free to organize your components however you like!
7074

75+
### `src/content`
76+
77+
The `src/content/` directory is reserved to store [content collections](/en/guides/content-collections/) and an optional collections configuration file. No other files are allowed inside this folder.
78+
7179
### `src/layouts`
7280

7381
[Layouts](/en/core-concepts/layouts/) are a special kind of component that wrap some content in a larger page layout. These are most often used by [Astro pages](/en/core-concepts/astro-pages/) and [Markdown or MDX pages](/en/guides/markdown-content/) to define the layout of the page.

0 commit comments

Comments
 (0)