<h1 align="center"> <a href="https://getmesh.io"> <img src="https://getmesh.io/assets/gentics-mesh-logo.png" width="420" alt="Gentics Mesh" /> </a> </h1> <h3 align="center">Gentics Mesh is your friendly, enterprise-grade, open-source headless CMS</h3> <p align="center"> To be honest, it’s more than that: it’s your application development platform to develop your websites, your IoT applications, your mobile apps, your smart devices and your digital signage solutions. With its best-in-class APIs, a complete feature list and great documentation, you’ll get your projects done successfully in less time, no matter which technology you prefer. </p> <br /> <p align="center"> <img src="https://img.shields.io/badge/status-stable-brightgreen.svg" alt="stable" /> <a href="https://www.apache.org/licenses/LICENSE-2.0"> <img src="https://img.shields.io/:license-apache-brightgreen.svg" alt="License" /> </a> <a href="https://stackoverflow.com/questions/tagged/gentics-mesh"> <img src="https://img.shields.io/badge/stack%20overflow-gentics--mesh-brightgreen.svg" alt="Stack Overflow" /> </a> <a href="https://gitter.im/gentics/mesh?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"> <img src="https://badges.gitter.im/gentics/mesh.svg" alt="Join the chat at https://gitter.im/gentics/mesh" /> </a> <a href="https://github.com/gentics/mesh/releases"> <img src="https://img.shields.io/github/v/release/gentics/mesh?sort=semver" alt="Latest release" /> </a> <a href="https://cla-assistant.io/gentics/mesh"> <img src="https://cla-assistant.io/readme/badge/gentics/mesh" alt="CLA assistant" /> </a> </p> <br /> <p align="center"> <a href="https://getmesh.io/"> <img src="https://getmesh.io/assets/mesh-heroimg.png" alt="Gentics Mesh Screenshot" style="max-width: 80%" /> </a> </p>

Quick Start

You can take a look at our demo application here:

• https://demo.getmesh.io/demo for the website
• https://demo.getmesh.io/mesh-ui for the CMS (login is admin/admin)

If you want to run the demo locally on your machine, the fastest way to get started is using docker:

docker run -p 8080:8080 gentics/mesh-demo:latest

If you can't use docker, go to the download page and get the JAR file, which you can then execute from the command line with:

java -jar mesh-demo-v.v.v.jar

<!-- XXX replace latest and v.v.v with up-to-date version XXX -->

Either way, now relax for a minute while the download and the initial database setup is performed. Then you can access the demo website locally at http://localhost:8080/demo and the CMS at http://localhost:8080/mesh-ui .

Check out our Getting Started Guide for an explanation of the basic concepts of Gentics Mesh.

Table of Contents

<!-- re-generate with https://github.com/ekalinin/github-markdown-toc -->

• Quick Start
• Table of Contents
• Introduction
  • Gentics CMP
  • What is a Headless CMS?
  • Why pick Gentics Mesh?
• Status
• Installation
• Features
• Documentation
• Getting Help
• Professional Services
  • Product Development
  • Consulting
  • Maintenance
  • Support
• Getting started developing with Gentics Mesh
  • Authentication
  • Using the REST API
  • Using the GraphQL API
• Contributing to Gentics Mesh
• Copyright & License

Introduction

Gentics CMP

Gentics CMP (Content Management Platform) is composed of the following components: Gentics CMS, Gentics Mesh, and Gentics Portal. Gentics CMS and Mesh are available as both open-source software (OSS) and Enterprise Edition (EE). Gentics Portal Java and PHP can only be acquired with the Enterprise Edition. You can find the EE features here: Open-Source and Enterprise Edition. For more information about the EE, please contact sales@gentics.com.

Here are the links to our open-source projects:

• Gentics CMS OSS: https://github.com/gentics/cms-oss
• Gentics Mesh OSS: https://github.com/gentics/mesh

What is a Headless CMS?

Traditional CMSes are "coupled", which means that the CMS also takes care of the presentation layer responsible for delivering the content to the clients. The content and the presentation are closely interlinked. Typically, content managers create and manage their content through tools like "What you see is what you get" (WYSIWYG) editors. The CMS then delivers the content according to the front-end delivery layer built into the CMS. Typically, a traditional CMS supports your websites but not much else.

A pure headless CMS is different, because it offers no front-end capabilities at all, giving you full control of your customer experience via APIs. The CMS typically provides content managers with a presentation and channel agnostic way of managing content. It requires a front-end development team to manage the rest with the frameworks and tools they prefer: The content can be loaded by external applications which handle the content delivery to the client, meaning that the content can be (re-)used by multiple applications and channels (web, mobile app, audio guides, IOT).

<p align="center"> <img src="https://getmesh.io/blog/gentics-mesh-1-0/headless-vs-coupled.png" alt="a coupled vs a headless CMS" style="max-width: 80%" /> </p>

Why pick Gentics Mesh?

Gentics Mesh is the platform that holds your content, gives you great APIs to access and modify it, while relieving you from handling permissions, multi-language aspects, search, and much more. You can use its modern user interface that makes content editing and administration enjoyable. At the same time, we don’t lock you in: You choose the technology and programming language you want to implement your application with. You decide whether you want to host it locally or in the cloud. We don’t care if you’re a Windows, Linux or Mac guy or girl. Also, with its Apache 2.0 license, you are free to use it, modify it and improve it.

What makes Gentics Mesh special over other headless CMSes is:

• its built-in user management not only covers the admin and editor features, but can also be used for handling access to your application.
• it thinks in content trees (just like websites do), which brings you many things for free: automatic navigation menus, automatic beautiful URLs, built-in link resolving, …​
• it is scalable and built for clustering, so your deployment can grow with your project’s success.

Status

Gentics Mesh is actively developed by a dedicated team at Gentics Software GmbH in Vienna, Austria.

<p align="center"> <img src="https://getmesh.io/blog/JPGs/CMP-DEV.jpg" alt="CMP DEV" style="max-width: 80%" /> </p>

The Gentics Mesh core team consists of the following members:

<p align="center"> <table align="center" style="width: 100%; max-width: 600px;"> <tr> <td align="center"> <a href="https://github.com/deckdom"> <!-- <img src="https://avatars.githubusercontent.com/pschulzk?size=150" width="150" /><br /> --> Dominik Decker<br /><i>UI/UX developer</i> </a> </td> </tr> <tr> <td align="center"> <a href="https://github.com/npomaroli"> <!-- <img