hunvreus/pagescms

The simplest CMS you'll ever need. Manage content and media right in your GitHub repository.

# Pages CMS [Pages CMS](https://pagescms.org) is an open source CMS for GitHub repositories. It is especially well suited for static sites and content-driven apps built with tools like Jekyll, Hugo, Next.js, Astro, VuePress, and similar stacks. You can use the hosted version directly at [app.pagescms.org](https://app.pagescms.org), or run your own local development copy from this repository. [](https://demo.pagescms.org) *[Watch the demo ▶](https://demo.pagescms.org)* ## Documentation Full documentation lives at [pagescms.org/docs](https://pagescms.org/docs). Useful starting points: - [Install locally](https://pagescms.org/docs/guides/installing/) - [Create the GitHub App](https://pagescms.org/docs/guides/installing/github-app/) - [Environment variables](https://pagescms.org/docs/development/environment-variables/) - [Upgrading to 2.x](https://pagescms.org/docs/guides/upgrading-to-2/) ## Use online The easiest way to get started is the hosted version at [app.pagescms.org](https://app.pagescms.org). Use that if you want to: - try Pages CMS immediately, - edit content without running anything locally, - stay on the latest hosted version. ## Local development ### What you need - PostgreSQL - a GitHub App - a local `.env.local` - the Pages CMS repo checked out locally ### Quick start 1. Clone the repository: ```bash git clone https://github.com/pagescms/pagescms.git cd pagescms ``` 2. Start PostgreSQL locally: ```bash docker run --name pagescms-db -e POSTGRES_USER=pagescms -e POSTGRES_PASSWORD=pagescms -e POSTGRES_DB=pagescms -p 5432:5432 -d postgres:16 ``` 3. Install dependencies: ```bash npm install ``` 4. Create `.env.local` with at least: ```bash DATABASE_URL=postgresql://pagescms:pagescms@l