Introduction

Grove is a framework for building structured community directories.

It gives you:

• a ready-to-use directory website
• YAML-based project records
• search and filtering
• GitHub metadata updates
• pull-request-based submissions
• static deployment

Grove currently supports project directories built with Astro. Two more blueprints (resource-hub and ecosystem-map) ship schemas today and land polished templates in V1.1.

What you can build

Grove fits problems where a community needs to curate a long-lived list of things — apps, tools, libraries, guides, organizations — and keep that list useful over months and years, not days.

Examples:

• an open-source app directory
• a developer tools index
• a local ecosystem map (cities, communities, schools)
• an internal knowledge hub (replacing spreadsheets with versioned data)
• a curated learning resources collection

How it works

You start with pnpm create grove my-directory and answer four prompts (blueprint, framework, GitHub mode, deploy target). The CLI copies the Astro template, writes grove.config.ts, generates GitHub Actions for validation and deployment, and installs dependencies. The dev server starts at http://localhost:4321.

You add records as YAML files under data/records/. You push a pull request. validate-data.yml checks the schema. Merge. build.yml deploys.

Every record is a file. Every change is reviewable. The site is static. There is no database, no CMS, no admin dashboard.

Ready to start?

Create a project directory → — scaffold your first Grove space in under 10 minutes.