📦 bevee

bevee is a lightweight, schema-first content layer inspired by Astro's Content Collections — but built to work with any frontend framework (like Next.js). It provides type-safe collection definitions, flexible data loaders, and runtime validation using Zod.

✨ Features

• ✅ Schema-first design with Zod
• ✅ Works with remote or local data
• ✅ Auto-validates your content at runtime
• ✅ Fully typed getEntry, getEntries, and getCollection APIs
• ✅ Supports references between collections
• ✅ Lazy loading with caching per collection
• ✅ Developer-friendly DX inspired by Astro Content Collections

🚀 Getting Started

1. Install

1npm install @repo/bevee zod

2. Define your collections

1// content/schema.ts
2import { z } from 'zod'
3import { reference, defineCollection } from '@repo/bevee'
4
5export const blogSchema = z.object({
6	title: z.string(),
7	slug: z.string(),
8	content: z.string(),
9	author: reference('authors'),
10})
11
12export const authorSchema = z.object({
13	name: z.string(),
14	bio: z.string(),
15})

3. Register them with defineCollection

1// content/index.ts
2import { createbevee, defineCollection } from '@repo/bevee'
3import { blogSchema, authorSchema } from './schema'
4
5export const bevee = createbevee({
6	blog: defineCollection({
7		name: 'blog',
8		schema: blogSchema,
9		loader: async () => [
10			{
11				id: 'welcome',
12				data: {
13					title: 'Welcome!',
14					slug: 'welcome',
15					content: 'Hello world',
16					author: { collection: 'authors', id: 'alice' },
17				},
18			},
19		],
20	}),
21	authors: defineCollection({
22		name: 'authors',
23		schema: authorSchema,
24		loader: async () => [
25			{
26				id: 'alice',
27				data: {
28					name: 'Alice',
29					bio: 'Loves TypeScript',
30				},
31			},
32		],
33	}),
34})

🧠 Usage

Load everything:

1await bevee.loadAll()

Get all blog posts:

1const posts = await bevee.getCollection('blog')

Filter collection entries:

1const published = await bevee.getCollection('blog', (entry) => entry.data.slug !== 'draft')

Get a single entry by ID:

1const post = bevee.getEntry('blog', 'welcome')

Resolve references:

1const author = bevee.getEntry(post.data.author)

Resolve multiple references:

1const related = bevee.getEntries(post.data.relatedPosts)

📚 Concepts

Concept	Description
defineCollection()	Defines a typed, schema-validated collection
createbevee()	Initializes bevee with your collections
loader()	Provides entries for each collection (can be remote or local)
reference('authors')	Defines a relationship to another collection

🛡️ Type Safety + Validation

All entries are type-checked at compile time using z.infer<typeof schema>, and also validated at runtime using Zod. Invalid entries will throw errors during loading.

🧪 Coming Soon

• getEntryBySlug() helper
• Markdown/MDX rendering support
• Dev-mode live reload for file-based sources
• File system loader (like Astro’s glob())

💬 Feedback

This is a pre-release. Please open issues or feature requests as you experiment! We’re excited to see what you build with bevee.