PagesCMS Integration
Integrates with the free and customisable PagesCMS editor
The Chobble template is an Eleventy static site, and like most static sites it's generated from simple text files. You could edit those text files manually, but their syntax is a bit clunky and it's easy to make a mistake. The PagesCMS editor makes this wayyy easier!
PagesCMS is a free CMS which connects to GitHub repositories, where your site's source code can be stored. Unlike many CMS systems PagesCMS is very flexible and the developer can create an admin interface that aligns with all sorts of collections or standalone pages. This means the interface only displays exactly what is needed for your site, with no cruft. And logging in is just a magic link via email - no passwords needed. It's very easy to use and intuitive.
The .pages.yml File
The PagesCMS interface is configured through the .pages.yml file, a single file which tells the editor that, for example, your site has "Menus", and each "Menu" has items, and each item has a price. And then it uses this info to create an editor for menus and items and prices for you.
That's the full extent of the PagesCMS configuration: one surprisingly-flexible config file. It lets us build very expansive interfaces that you can use to edit thousands of records, easy peasy.
GitHub Integration
There are lots of types of "source code repositories", but GitHub is the most popular one and is where Chobble Sites are best suited for. It's free to store your site's source code there, and then PagesCMS connects to that source code repository to let you edit your files.
Whenever you make a change, GitHub runs a script which turns the source code text files into your pretty new website. This happens in the background automatically, which means that a minute or so after hitting "Save" in the PagesCMS editor you can see your updates on your live site.
A big benefit of this all being based in Git and GitHub is that every version of your files is stored. This means you can always restore to an earlier version - it makes your site very hard to break.
Content Management Features
Users can create, edit, and delete any page or item on their site. That might be a full page like "About Us", or a product category, or an individual product, or maybe even just the small text that appears in the footer, something like "Copyright Chobble 2025".
The editor is really simple: There are no complex font options, it just happens through plain text boxes. You can use the Markdown language for advanced formatting. This might feel confusing initially, but you'll quickly get used to it, and it's much harder to make a mistake through this editor than through a full HTML editor.
You can also upload images through the PagesCMS editor, and link those images to products, menu items, page headers, and anywhere else we use an image. Likewise you can link products to categories, reviews to products, and so on.
Getting Started
Setting it up is really easy. Once you've got your source code stored on Github, you just need to go to PagesCMS.org and follow the big buttons. It's all free and just takes a few clicks for you to add the PagesCMS editor to your repository.
If you're a paying Chobble customer, I'll manage all this for you and you'll get an invite link in your emails. But if you're using the Chobble Template yourself, it's really easy to get working.
- Free and open source CMS
- GitHub integration with automatic deployments
- Customizable interface via `.pages.yml`
- Magic link authentication (no passwords)
- Version history and easy restoration
- Image upload and linking
- Support for all content types (pages, products, categories, etc.)
-
Jan '25
The theme system is consistent. Ten pre-built themes are available and the live theme editor makes customisation simple.
-
Jan '25
The e-commerce features work well. Shopping cart and Stripe checkout are all included.
Mini Gizmo with Local Image -
Jan '25
Configuration options are flexible. Payment providers, form handlers, and site features can all be toggled in the config files.
-
Jan '25
Testing is straightforward. The test utilities provide helpful factories and the quality criteria are well defined.
-
Jan '25
Documentation is comprehensive. The CLAUDE.md file explains the project structure, conventions, and common patterns clearly.
Pocket Doodah Mini, Mini Gizmo with Local Image -
Nov '24
The build process is fast. Bun handles dependencies and the test suite runs quickly.
-
Sep '24
Image processing is handled automatically. Responsive images with low quality placeholders are generated during the build process.
Pocket Doodah Mini -
Aug '24
The property listing system is well organised. Each property can have its own gallery, features list, and booking information.
-
Jun '24
The code is quite tidy. Functions are small, imports use aliases, and the linter keeps everything consistent.
-
Jan '24
There are lots of collection types. Products, categories, events, news, menus, locations, properties, reviews, and team profiles are all supported out of the box.
Pocket Doodah Mini