1. You log in with your GitHub account.
2. You select the GitHub repo where your site/app is at (whether it's Next.js, 11ty, Hugo, Nuxt... as long as you're using flat files for content).
3. You add a single config file to your repo to define the content types and other settings (e.g. media folder).
4. Congrats: you now have a user friendly CMS to manage content + media BUT all changes are still tracked like regular commits (under your account) on GitHub.
I started using Jekyll around 2009 and over the course of the past 10+ years, I've helped build major sites and tiny blogs with Hugo, Gatsby, Next.js and more recently 11ty.
I still love it.
BUT once you're done building, managing content and media can be a bit of a pain. You have a few options:
- Edit files directly (on GitHub or your local). Good luck getting your colleagues on the marketing team to do that.
- Hook up a headless CMS like Contentful, Sanity, or Strapi. That works, but it's one more dependency and (IMHO) overkill in most cases.
- OR you could use something like [Decap CMS](https://decapcms.org/). Really cool project, but I've never been a fan of the UI/UX, and it's been a bit of a pain to setup (maybe that's just me).
I wanted something as simple as possible, preferably with nothing to install or deploy.
Back in 2018, I had built a prototype (Jekyll+) [1] with the idea of getting a CMS set up by just adding a single configuration file to your GitHub repository.
Pages CMS [2] is a continuation of that idea. It's 100% free and Open Source: https://github.com/pages-cms/pages-cms.
If you don't want to use the online version because you're not comfortable signing up with your GitHub account, consider the following options:
- Use a fine-grained personal access token [3], there's an option on the login screen. There is still a bug if you try to access a repo that isn't part of your token scope, but I'll get it fixed in the next couple of days.
- Deploy it yourself (for free) on Cloudflare Pages. Literally 5 minutes of work max. I made a video walking you through the process [4].
- Check out the intro video on the front page [2] (a bit crap, but I'll get a better one up in the next few days).
I use it actively with a few other teams, I hope it will be of use to some of you.
I'm already working on adding a few nicer features, like collaborative editing and email invites (to let non-developers login without a GitHub account).
PS: I've spent the past 8+ years building a business and only recently got back into coding. I'd love pointers as to what I could do better (and how I can manage my Powerpoint PTSD).
[1]: https://github.com/hunvreus/jekyllplus/
[2]: https://pagescms.org
[3]: https://docs.github.com/en/authentication/keeping-your-accou...