apostrophe

ApostropheCMS 3

ApostropheCMS is a full-featured, open source CMS built with Node.js that seeks to empower organizations by combining in-context editing and headless architecture in a full-stack JS environment.
Documentation »

Demo · Roadmap · Report Bug

About ApostropheCMS

ApostropheCMS is content software for everyone in an organization. It helps teams of all sizes create dynamic digital experiences with elegance and efficiency by blending powerful features, developer happiness, and a low learning curve for content creators. Apostrophe has powered websites and web apps for organizations large and small for over a decade.

Built With

• Node
• MongoDB
• Nunjucks

Getting Started

To get started with Apostrophe 3, follow these steps to set up a local development environment. For more detail, refer to the A3 getting started guide in the documentation.

Prerequisites

We recommend installing the following with Homebrew on macOS. If you're on Linux, you should use your package manager (apt or yum). If you're on Windows, we recommend the Windows Subsystem for Linux.

Software	Minimum Version	Notes
Node.js	12.x	Or better
npm	6.x	Or better
MongoDB	3.6	Or better
Imagemagick	Any	Faster image uploads, GIF support (optional)

Community

Discord - Twitter - Discussions

Contributing

We eagerly welcome open source contributions. Before submitting a PR, please read through our Contribution Guide

License

ApostropheCMS is released under the MIT License.

Changelog

4.3.0 (2024-05-15)

Adds

• Allows to disable page refresh on content changed for page types.
• Widget editor can now have tabs.
• Adds prop to AposInputMixin to disable blur emit.
• Adds throttle function in ui module utils.
• Adds a publicBundle option to @apostrophecms/asset. When set to false, the ui/src public asset bundle is not built at all in most cases except as part of the admin UI bundle which depends on it. For use with external front ends such as apostrophe-astro. Thanks to Michelin for contributing this feature.

Fixes

• Do not show widget editor tabs when the developer hasn't created any groups.
• npm link now works again for Apostrophe modules that are dependencies of a project.
• Re-crop image attachments found in image widgets, etc. when replacing an image in the Media Manager.
• Fixes visual transitions between modals, as well as slider transition on overlay opacity.
• Changing the aspect ratio multiple times in the image cropper modal no longer makes the stencil smaller and smaller.

Changes

• Improves debounce function to handle async properly (waiting for previous async call to finish before triggering a new one).
• Adds the copyOfId property to be passed to the apos.doc.edit() method, while still allowing the entire copyOf object for backwards compatibility.

Fixes