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

3.45.0 (2023-04-27)

Adds

• Rich text widgets now support the insert option, an array which currently may contain the strings image and table in order to add a convenient "insert menu" that pops up when the slash key is pressed. This provides a better user experience for rich text features that shouldn't require that the user select existing text before using them.
• Auto expand inline array width if needed using width: max-content in the admin UI.
• The "browse" button is now available when selecting pages and pieces to link to in the rich text editor.
• The "browse" button is also available when selecting inline images in the rich text editor.
• Images are now previewed in the relationship field's compact list view.
• The new apos-refreshing Apostrophe bus event can be used to prevent Apostrophe from refreshing the main content zone of the page when images and pieces are edited, by clearing the refresh property of the object passed to the event.
• To facilitate custom click handlers, an apos.modal.onTopOf(el1, el2) function is now available to check whether an element is considered to be "on top of" another element in the modal stack.

Changes

• The v-click-outside-element Vue directive now understands that modals "on top of" an element should be considered to be "inside" the element, e.g. clicks on them shouldn't close the link dialog etc.

Fixes

• Fix various issues on conditional fields that were occurring when adding new widgets with default values or selecting a falsy value in a field that has a conditional field relying on it. Populate new or existing doc instances with default values and add an empty null choice to select fields that do not have a default value (required or not) and to the ones configured with dynamic choices.
• Rich text widgets save more reliably when many actions are taken quickly just before save.
• Fix an issue in the oembed field where the value was kept in memory after cancelling the widget editor, which resulted in saving the value if the widget was nested and the parent widget was saved. Also improve the oembed field UX by setting the input as readonly rather than disabled when fetching the video metadata, in order to avoid losing its focus when typing.