Rift Logo RiftJS

5/10/2025

Collections, Not Conventions: Group Your Content Intentionally

#collections #content #architecture

Collections, Not Conventions: Group Your Content Intentionally

Frameworks love to treat your folders like logic.

Drop a file in posts/, and it's magically a post. Nest something in projects/ and it’s supposed to mean something special. But what if your site has 3 languages? Or multiple content types? Or multiple post formats?

Then you're stuck organizing content for your generator, not your team.

Rift flips that.


📦 Define Collections with Intent

In Rift, you declare your collection by adding a frontmatter key:

collection: posts

That’s it.

You can put the file anywhere. Name it anything. Rift doesn’t care where it lives — just what it is.


🧠 No More Folder-Based Inference

Other SSGs make dangerous assumptions:

  • A file in content/blog/ must be a blog post
  • A file in projects/ must follow some plugin logic
  • Nested folders become slugs, whether you like it or not

That’s fragile.

Rift avoids all of this by letting you group by metadata — not paths. You get clean intent, not guesswork.


🔄 Centralized Collection Access

Want all your posts? In a controller, it’s just:

const posts = context.collections.posts

From there, paginate, filter, localize, or do anything else you need — based on actual content values, not file hierarchy hacks.


✨ Real Grouping. Real Use Cases.

With Rift collections, you can:

  • Localize your content — collection: docs, locale: fr
  • Organize by purpose — collection: changelog, collection: help
  • Render filtered indexes — like “all blog posts tagged react

And since it’s all just objects, you can manipulate it however you want.


🧪 Simpler Sites. Smarter Structure.

You shouldn’t have to fight your folder tree to make your content work.

Rift gives you simple, intentional, metadata-driven grouping — so your site structure reflects your needs, not your framework’s opinions.


🧰 Try It Now

npm create rift@latest

Group your content your way. Rift won’t stand in your way.

Build Your Own Blog with Rift

Rift is a zero-guesswork static site generator built for developers. Try it today:

npm create rift@latest