Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nedpals/sulatcms
Super simple platform-agnostic headless CMS
https://github.com/nedpals/sulatcms
cms git headless-cms jamstack javascript static
Last synced: 1 day ago
JSON representation
Super simple platform-agnostic headless CMS
- Host: GitHub
- URL: https://github.com/nedpals/sulatcms
- Owner: nedpals
- Archived: true
- Created: 2018-02-25T09:49:23.000Z (almost 7 years ago)
- Default Branch: next
- Last Pushed: 2020-09-04T01:11:35.000Z (over 4 years ago)
- Last Synced: 2024-09-25T18:49:48.149Z (4 months ago)
- Topics: cms, git, headless-cms, jamstack, javascript, static
- Language: JavaScript
- Size: 814 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
> **ATTENTION**: This is currently in development. Please wait for the stable release.
> You are looking for the next version of SulatCMS currently developed right now.
# SulatCMS [](https://codeclimate.com/github/nedpals/sulatcms/maintainability)
Simple plugin-driven Headless CMS for JAMstack sites.
## Features
1. **Platform-agnostic** - Edit your markdown posts from your local filesystem, git, WordPress, and etc.
2. **Plugin-driven** - From content manipulation to publishing your content, they are all handled by plugins.
3. **Barebones** - A Sulat installation with no plugins only weighs about `60kb` compared to previous version.
4. **Powered by [Mithril](https://mithril.js.org)** - A tiny, complete out-of-the box Javascript library makes Sulat slim and fast.
## Install
To start, install Sulat via NPM/Yarn or
```bash
yarn add https://github.com/nedpals/sulatcms#next
```
or you can embed it directly
```html
```
### Usage
To get started, initialize first the CMS by invoking the `initialize` function. If you are setting up in the browser without any build tools, you can access it through `window.sulat`.
```javascript
sulatcms.initialize({
el: document.getElementById("sulat"),
auth: "netlify", // if you are using authentication, you need to set the default provider.
plugins: [
//... plugins goes here.
netlifyIdentityPlugin(),
gitlabPlugin()
]
})
```
Once you set up and install all the plugins, you're good to go!
## Plugins
What makes SulatCMS unique is the first-class support of plugins. Plugins what makes the CMS functionable from content management to authentication.
### Creating a plugin
SulatCMS plugins are just regular functions returning a single plugin object. The plugin object contains metadata for the plugin (name and etc.) as well as it's event functions both for the CMS and authentication management.
```javascript
function myFirstPlugin(options) {
return {
name: "my-first-plugin",
events: {
onInit() {
console.log("Hello " + options.name);
}
}
};
}
```
### Using the plugin
You can simply add the plugin to the CMS's config:
```javascript
initialize({
// ...
plugins: [myFirstPlugin({
name: "Bob"
})]
//...
})
```
As soon as the as the CMS is loaded, the plugins are automatically loaded. In this case, our plugin executes after the CMS has been fully loaded.
## Development Notes
- Plugin system now implemented. I'm gonna think first what set of APIs will be implemented.
## Pre-launch plans
- [x] ~~Make Github and Gitlab as default platforms~~
- **Note:** Login only works on Netlify sites. Still working on making it usable for non-Netlify sites.
- [x] ~~Implement few API's for plugins~
- [ ] Cleanup the UI
- [x] Target file size should be atleast between *100-300kb*
## Contribute
To start:
```bash
$ npm install
```
To develop:
```bash
$ npm run dev
```
To build for production:
```bash
$ npm run build
```
---
© 2018 [nedpals](https://github.com/nedpals).