Skip to content
NaturaLife Astro Theme

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.

All paths below are relative to your website’s root folder.

PathWhat 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.jsonRegistered 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.mjsExisting 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.

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.

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.