Type something to search...
to navigateto selectESC to close

Site Structure

Understanding your Astrolock project layout

Your Astrolock site has a specific folder structure. Here’s what each part does.

Folders You’ll Use

These are the folders you’ll work with regularly:

content/ - Your Content

All your written content lives here as Markdown files.

content/
├── blog/              # Blog posts
│   ├── -index.md      # Blog landing page
│   └── my-post.md     # A blog post
├── authors/           # Author profiles
└── pages/             # Standalone pages

Tip

Files starting with - (like -index.md) are special landing pages for each section.

public/ - Media Files

Images, audio files, and other assets go here:

public/
├── images/
│   ├── site/          # Logo, favicon, defaults
│   └── content/       # Images for your content
│       └── blog/      # Blog post images
├── audio/
│   └── content/       # Audio files
│       └── mixes/     # e.g., DJ mixes
└── video/
    └── content/       # Video files

  1. Put your image in the appropriate folder:

    public/images/content/blog/my-image.jpg

  2. Reference it in your Markdown:

    ![My image](/images/content/blog/my-image.jpg)

Or use the image frontmatter field for featured images:

---
title: "My Post"
image: "/images/content/blog/my-image.jpg"
---

  1. Put your audio file in the audio folder:

    public/audio/content/mixes/my-mix.mp3

  2. Reference it in your content’s frontmatter using the media field. See Audio Collections for details.

Configuration Files

Your site is configured through YAML files:

FilePurpose
.astrolock/astrolock.yamlMain configuration: site, collections, menus, plugins
.astrolock/astrolock.yamlDeployment settings (optional)

Warning

The .astrolock/ folder may contain sensitive credentials. Don’t share these files publicly. We’ve generated a .gitignore which will ignore all the most common paths, but check yourself if you are using Git to store your content!

Generated Folders

These folders are created automatically - don’t edit them manually:

FolderPurpose
dist/Built site files (created by astrolock build)
.json/Search index data
node_modules/Dependencies (managed by Astrolock)

Info

If something breaks, you can safely delete dist/ and .json/ - they’ll be regenerated on the next build.

Next Steps