2016-06-05 12:48:28 -07:00
# Netlify CMS
2019-04-06 03:05:44 +05:00
[![Gitter Chat ](https://badges.gitter.im/Join%20Chat.svg )](https://gitter.im/netlify/netlifycms)
2016-06-05 12:48:28 -07:00
2019-03-25 19:12:34 +01:00
A CMS for static site generators. Give users a simple way to edit
2016-06-05 12:48:28 -07:00
and add content to any site built with a static site generator.
2019-04-06 03:05:44 +05:00
## How It Works
2016-06-05 12:48:28 -07:00
Netlify CMS is a single-page app that you pull into the `/admin` part of your site.
It presents a clean UI for editing content stored in a Git repository.
You setup a YAML config to describe the content model of your site, and typically
tweak the main layout of the CMS a bit to fit your own site.
2019-04-06 03:05:44 +05:00
When a user navigates to `/admin/` they'll be prompted to log in, and once authenticated
2017-03-17 16:12:25 +00:00
they'll be able to create new content or edit existing content.
2016-09-20 11:29:45 -03:00
2017-12-05 09:05:42 -07:00
Read more about Netlify CMS [Core Concepts ](https://www.netlifycms.org/docs/intro/ ).
2016-09-20 11:29:45 -03:00
2017-02-08 16:29:15 -02:00
# Installation and Configuration
2016-09-20 11:29:45 -03:00
2017-02-08 16:29:15 -02:00
The Netlify CMS can be used in two different ways.
2016-09-20 11:29:45 -03:00
2019-04-06 03:05:44 +05:00
* A Quick and easy install, that requires you to create a single HTML file and a configuration file. All the CMS Javascript and CSS are loaded from a CDN.
2018-08-07 14:46:54 -06:00
To learn more about this installation method, refer to the [Quick Start Guide ](https://www.netlifycms.org/docs/quick-start/ )
2018-08-14 11:33:13 -06:00
* A complete, more complex install, that gives you more flexibility but requires that you use a static site builder with a build system that supports npm packages.
2017-01-22 13:09:20 +00:00
2017-03-20 10:56:46 -07:00
# Community
2018-02-26 23:37:05 +07:00
Netlify CMS has a [Gitter community ](https://gitter.im/netlify/netlifycms ) where members of the community hang out and share things about the project, as well as give and receive support.
2017-03-20 10:56:46 -07:00
2018-10-24 18:45:57 -05:00
# Contributing
New contributors are always welcome! Check out [CONTRIBUTING.md ](https://github.com/netlify/netlify-cms/blob/master/CONTRIBUTING.md ) to get involved.
2017-02-08 16:29:15 -02:00
# Change Log
2016-09-20 11:29:45 -03:00
2017-09-14 01:08:43 +02:00
This project adheres to [Semantic Versioning ](http://semver.org/ ).
2017-02-08 16:29:15 -02:00
Every release is documented on the Github [Releases ](https://github.com/netlify/netlify-cms/releases ) page.
2016-09-20 11:29:45 -03:00
2017-02-08 16:29:15 -02:00
# License
2016-09-20 11:29:45 -03:00
2017-02-08 16:29:15 -02:00
Netlify CMS is released under the [MIT License ](LICENSE ).
Please make sure you understand its [implications and guarantees ](https://writing.kemitchell.com/2016/09/21/MIT-License-Line-by-Line.html ).
2016-11-11 16:19:25 -08:00
2018-04-11 17:47:23 -04:00
# Thanks
2016-11-11 16:19:25 -08:00
2018-04-11 17:47:23 -04:00
## Services
These services support Netlify CMS development by providing free infrastructure.
2018-04-11 17:54:25 -04:00
< p >
2018-04-11 17:47:23 -04:00
< a href = "https://www.travis-ci.org" >
2019-04-06 03:05:44 +05:00
< img src = "https://raw.githubusercontent.com/netlify/netlify-cms/master/img/travis.png" height = "38" alt = "travis-ci" / >
2018-04-11 17:47:23 -04:00
< / a >
2018-04-11 17:54:25 -04:00
< img src = "https://spacergif.org/spacer.gif" width = "20" / >
2018-04-11 17:47:23 -04:00
< a href = "https://www.browserstack.com" >
2019-04-06 03:05:44 +05:00
< img src = "https://raw.githubusercontent.com/netlify/netlify-cms/master/img/browserstack.png" height = "38" alt = "browserstack" / >
2018-04-11 17:47:23 -04:00
< / a >
2019-05-29 08:18:29 +06:30
< a href = "https://www.cypress.io" >
< img src = "https://raw.githubusercontent.com/netlify/netlify-cms/master/img/cypressio.png" height = "38" alt = "Cypress.io" / >
< / a >
2018-04-11 17:47:23 -04:00
< / p >