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.4.0 (2024-06-12)

Adds

• Adds a pinia store to handle modals logic.
• Methods from the store are registered on apos.modal instead of methods from TheAposModals component.
• No more need to emit safe-close when defining an AposModal, modal is automatically resolved when closed.
• Adds field components access to the reactive document value.
• Expose AposContextMenu owned method for re-calculation of the content position.
• Field Meta components of slug and string types can now fire replace-field-value events with text value payload, which will replace the respective field value.
• AposInputString now accepts a rows prop, in effect only when field.textarea is set to true.
• Add T,S shortcut to open the Personal Settings.
• Add T,D shortcut to open the Submitted Drafts.
• Add a scrollbar to the shortcut list.
• Add breadcrumbs to search results page.
• Pages relationships have now their checkboxes disabled when max is reached.

Changes

• Improves widget tabs for the hidden entries, improves UX when validation errors are present in non-focused tabs.
• When moving a page, recognize when the slug of a new child already contains the new parent's slug and not double it. For example, given we have two pages as children of the home page, page A and page B. Page A and page B are siblings. Page A has the slug /peer and page B has the slug /peer/page. Now we want page B to be the child of page A. We will now end up with page B slug as /peer/page and not /peer/peer/page as before.
• AposSpinner now respects the colors for heavy weight mode and also accepts second, "light" color in this mode. Props JSDoc blocks are added.
• AposContextMenu now respects the menuOffset component property.
• Set G,Shift+I shortcut to open the Image Tags manager modal.
• Set G,Shift+F shortcut to open the File Tags manager modal.
• Remove slug from suggestion for images.
• Increase suggestion search image size to 50px.
• For suggestions with image, keep title on a single line and truncate title field with ... when it hits the right side.

Fixes

• Rich Text editor properly unsets marks on heading close.
• Widget client side schema validation.
• Allow G,Shift+I shortcut style.
• Detect shortcut conflicts when using multiple shortcuts.
• Updating schema fields as read-only no longer reset the value when updating the document.
• Fixes stylelint config file, uses config from our shared configuration, fixes all lint errors.
• Fixes TheAposCommandMenu modals not computing shortcuts from the current opened modal.
• Fixes select boxes of relationships, we can now check manually published relationships, and AposSlatList renders properly checked relationships.
• Fixes issues in AposInputArray on production build to be able to add, remove and edit array items after required error.
• Relationships browse button isn't disabled when max is reached.
• In media manager images checkboxes are disabled when max is reached.