Project Structure
Find where your pages, content, settings and assets live, and understand how your editable project files relate to the theme core and generated output.
Find the file for your task
Section titled “Find the file for your task”All paths below are relative to your website’s root folder.
| Path | What you edit there |
|---|---|
src/pages/ | Astro routes, section order and page composition |
src/content/pages/ | Designed-page JSON, including page-specific layout and section settings |
src/content/blog/posts/ | Blog MDX articles |
src/content/blog/authors/, categories/, tags/ | Author and blog taxonomy JSON records |
src/content/products/items/ | Product MDX descriptions and demo catalog data |
src/content/products/categories/, tags/ | Product taxonomy JSON records |
src/content/portfolio/items/, categories/ | Project MDX records and portfolio category JSON |
src/content/documents/ | Ordinary MDX text pages |
src/settings/ | Shared site, blog, product and portfolio settings |
src/assets/ | Original images and customer assets |
src/content/media/images.json | Registered designed-page image sources and output sizes |
src/components/ | Your local sections and copied/customized components |
src/lib/ | Customer-owned content queries, normalization and pagination |
astro.config.mjs | Existing integration, component/template selections and deployment base |
Keep global settings in src/settings/; do not create duplicate src/data/ or src/content/site/ settings. The internal Astro collection named site reads src/settings/site.json.
Theme core and delivery metadata
Section titled “Theme core and delivery metadata”vendor/ holds the versioned core archive referenced by package.json and package-lock.json. After installation, readable core code is available in node_modules/@rtthemes/naturalife/. Edit your own source files; changes inside node_modules/ are lost on reinstall.
.rtthemes/kit.json describes the supplied product, version, content capabilities and integration reference. It is generated for the matching core and lockfile. Do not hand-edit it to claim another version. The CLI creates .rtthemes/project.json as the project’s installation receipt. Keep it with the matching core, lockfile and kit.
Generated files
Section titled “Generated files”dist/, .astro/, .cache/images/ and generated public/assets/ files are build output. Edit original media and source records, then rebuild. Keep your source project and its matching vendor/lock metadata backed up separately from the deployed dist/ output.
Get all RT-Themes designs, updates and support with a single Club license.
Join the Club