parkuman / pocketcms

PocketCMS

PocketCMS is an open source content management system leveraging PocketBase as its foundation. PocketCMS offers:

• a user-facing CMS admin portal alongside PocketBase's admin UI
• using PocketBase's client-side SDKs within your application for fetching data from PocketCMS

PocketCMS's mission is to bring the simplicity of PocketBase's developer experience and admin interface to less tech-savvy users who only need to focus on managing website content.

Instructions

By installing PocketCMS, you are essentially also installing PocketBase with some additional features and plus another embedded single-page-application acting as the CMS admin portal. The instructions for deploying are therefore very similar to PocketBase's.

To run as a standalone application, download the prebuilt executable from the Releases page. Once downloaded, extract the archive and run ./pocketcms serve in the extracted directory.

From there, PocketBase will run in its usual path of localhost:8090/_/ and PocketCMS will run at localhost:8090/cms/. Before using PocketCMS, some initial collection and user setup is required.

Initial Setup

1. log in to pocketbase at localhost:8090/_/
2. visit pocketcms at localhost:8090/cms/ and create your first user
3. voila!

Now that you are set up, any collections you create inside PocketBase prefixed with pcms_ and with api rules not set to admin only, those collections will be available in PocketCMS.

To fetch from these collections, you can use the PocketBase client-side SDKs just as you would any other PocketBase collection! For more information on fetching data from PokcetCMS/PocketBase, see PocketBase's documentation.

Development

Feel free to raise issues and PRs! Any suggestions are welcome.

To run pocketbase and pocketcms

1. Clone the repo
2. run

go mod tidy
go run main.go serve

UI Development

1. Run pocketcms like above
2. in another terminal, open the ui/ dir and run:

pnpm run dev

which should spin up vite at localhost:3000. This will give you all the HMR goodness.

pocketcms's Issues

No collection after creating first user

I can't see any collection after creating the first user for cms. Also there is no collection creation option.

Auto setup PocketCMS

Just like the magic with PocketBase. We want PocketCMS to auto setup the necessary collections & fields on first use.

automatic setup on first load of PocketCMS

Flow is as follows

graph TD
	A[Visit PocketCMS] --> D[Logged in to PocketBase already?]
	F[Visit PocketBase] --> B[Complete PocketBase installer]
	B --> A
	D -->|no, redirect to PocketBase| F
	D -->|yes| E[complete PocketCMS installer]

Loading

improve logic for hiding create/delete buttons based on the rules permitted by the collection

right now we hide the create / delete buttons if the rule is null. we should show these buttons if the user actually has permission to do that action, rather than assuming they can perform that action