genesys

ApostropheCMS is a content management system (CMS) for Node.js. It supports in-context editing, schema-driven content types, flexible widgets and a great deal more. This module contains everything necessary to build a website with ApostropheCMS.

Please see the ApostropheCMS documentation for detailed information about building sites with ApostropheCMS.

Getting Started

The ApostropheCMS documentation will walk you through some simple steps to get your local environment set up with the technology stack that runs ApostropheCMS (Node.js, MongoDB, ImageMagick) along with installing ApostropheCMS itself.

Then create a new project on your computer and work on building your beautiful website.

The ApostropheCMS documentation will walk you through editing page templates, global content, creating custom widgets and navigation, along with configuring reusable "pieces" and global settings. Plus, a whole lot more!

Taking it Further

Our documentation also covers advanced topics such as managing permissions, working with ApostropheCMS data, building forms, and hosting an ApostropheCMS site in production.

Moreover, there's tons of great info in the "How To" section of the docs, and it's always growing!

Extending the Core with Modules

ApostropheCMS is Node.js all the way through, which means it can be extended in all sorts of interesting ways. Here's a list of some of our favorite modules:

• genesys-headless - Add REST APIs and power your React / Vue / Native / etc. apps with a headless CMS.
• genesys-blog - Everything you need to put a blog on your site.
• genesys-events - Manage upcoming events.
• genesys-workflow - Add powerful localization capabilities to your project.
• genesys-passport - Authenticate via Twitter, Facebook, Github and more.
• genesys-saml - Authenticate via Shibboleth, as well as corporate SAML environments like Salesforce.
• genesys-places - Manage geotagged content and display it on a map.
• genesys-redirects - An easy redirects module.

Additional Resources

We've got some great open-source tools and how-to articles that can help you out deploying, managing and maintaining ApostropheCMS sites.

Community

Report bugs and submit pull requests via github.

Ask how-to questions via StackOverflow. Be sure to tag them genesys-cms.

Stay up to date with announcements on our forum.

Chat with the community on our Discord server.

License

ApostropheCMS is released under the MIT License.

Changelog

2.93.0 (2019-07-25)

• New, simplified static asset bundling feature for deploying to cloud hosts like Heroku. See the ApostropheCMS Heroku HOWTO for details. There is more to successful Heroku deployment than just static assert bundling.

First, make sure the APOS_BUNDLE=1 environment variable is set in your production environment, i.e. in your Heroku environment settings.

Next, set up a "release tasks" script:

# Remember, APOS_BUNDLE=1 must be set globally in your Heroku
# environment settings already - not just this script but also
# the regular dyno startup must see it

node app apostrophe:generation
node app genesys-migrations:migrate

And that's all you have to do! No more creating named bundles and committing them to git. That technique still works, but it is much more work for you.

This new method does require that the release tasks script have access to the production database, as MongoDB is used to store the bundle until the Heroku dynos have a chance to unpack it locally.

Due to the temporary storage of the bundle in MongoDB, if your asset bundle is larger than 16MB this technique will not work... and your users will be miserable, waiting for a 16MB asset bundle to download on their phones! So please, just don't push that much code to the browser. If you must though, you can use the old technique.

Again, see the ApostropheCMS Heroku HOWTO for details. There is more to successful Heroku deployment than just static assert bundling, most importantly you need to use S3 for media storage.

• In the lean library (genex.utils.post), use the csrf-fallback value for the csrf token if there is no csrf cookie name, same as the regular jquery library would. This achieves compatibility with the disableAnonSessions: true option of genesys-express.

• When copying the permissions of a parent page to subpages, you now have the option to append them rather than replacing all existing permissions. Thanks to Siddharth Joshi.