Livingdocs is a modern Digital Content Creation and Publishing System that drives the efficiency of editorial staff using a unique building blocks technology and powerful collaboration tools.
It is also a configurable headless CMS as a service that enables developers to model pretty much every publishing use case imaginable. This documentation is here to help you master the complexities of Livingdocs’ configuration and setup your specific use case.
Read on to learn about the most important concepts of Livingdocs.
A Livingdocs project is easiest understood as a publication. This can be a newspaper, blog, website or pretty much every imaginable digital publication. Upon signing up for the Livingdocs service a Sandbox is created for you. This is a project. You can also create your own projects and invite teams to them. The number of projects you are allowed to create depends upon your chosen service plan.
This is where you configure your publication. A publication might have different content-types like articles or image galleries. Those in turn have metadata and component sets out of which editors can create content. In order to manage all of those settings you will use the Livingdocs CLI that is explained in the next chapter.
The project-config is the source for the project setup. It’s a huge JSON file that contains all settings you applied to your project. The UIs in the “Project Setup” section alter the project-config JSON and you can always see the complete JSON in the “History” screen of the “Project Setup” (it’s versioned as well). You can also write to this JSON directly using our CLI, more on this later.
(You might come across the term “channel-config”, this is just the old name of the project config)
The Design is a part of the project-config (subproperties
components). It defines the assets used to render (CSS, JS, etc.) as well as the available components (HTML templates). Those components will then be visible in the sidebar of the Livingdocs editor and users can drag them in to create articles and documents.
The Livingdocs CLI allows you to download and re-upload the project-config of your project. This is very useful if you want to locally work on your configuration and collaborate on it with other developers, e.g. by pushing it to a Github repo.
Users can have many projects and projects can have many users. You are a user once you have signed up with Livingdocs. You can also invite users to your projects and assign them to groups. Groups can give different rights (read-only, publish, etc.) to your users so you can segment your team in e.g. admins, editors and editors in chief.
This is where you can interact with Livingdocs over a REST interface. The API allows you to: get content out of Livingdocs (publications, menus, etc.), import content into Livingdocs and alter the configuration of your project (project-config) though for the latter you can also use the CLI.
Livingdocs on Vimeo
You can find more videos directly on vimeo: