# Changes from Apostrophe 2
Apostrophe 3 (A3) has many things to offer developers familiar with Apostrophe 2 (A2). It has a totally new UI, clearer module configuration, and many quality of life improvements, large and small. Its been re-engineered from the ground-up to provide a best-in-class experience for organizations of all sizes.
There are also some breaking changes, including in the general directory structure, so be sure to review the upgrading guide before upgrading codebases.
# 100% RESTful API coverage
In the previous version, developers who wanted REST API access to their data needed to install the
apostrophe-headless module. This is now built into A3 and is the foundation of the user interface.
# Totally rebuilt content editing interface
# Clearer and easier module building
There were several things about building advanced modules in A2 that often tripped up developers. A3 helps avoid the confusion around where to put things by doing away with
afterConstruct. They are replaced by a single
init function and special sections to do things like extend API routes, add template helper methods, and add columns to the piece manager UI. The
addFields array also became a
fields object with an
add subproperty to prevent problems with common inheritance patterns.
# New Rich Text Editor
# Async template components
Async components allow developers to write template code that uses data from custom database requests. In A2, the pattern to make those requests before rendering templates was unclear and fairly advanced. Async components should make this a clearer process and improve rendering performance.
# Other improvements
awaitthem in async functions.
- A3 completely removes the jQuery, lodash, and Moment.js libraries that were pushed to browsers by default. There is now only a small set of helper methods.
- In addition to the classic template macros, there are now fragments. These are compatible with the new async components, unlike macros.
- Content localization, which was a feature of Apostrophe Workflow for A2, is now fully available in A3 core.
There are additional features planned for Apostrophe 3. Keep an eye on the product roadmap (opens new window) for more on those.