strapi/README.md

145 lines
6.0 KiB
Markdown
Raw Normal View History

2018-08-21 01:31:10 -07:00
<p align="center">
<a href="https://strapi.io">
<img src="https://strapi.io/assets/strapi-logo-dark.svg" width="318px" alt="Strapi logo" />
2018-08-21 01:31:10 -07:00
</a>
</p>
2017-09-29 11:29:17 +02:00
<h3 align="center">API creation made simple, secure and fast.</h3>
<p align="center">The most advanced open-source headless CMS to build powerful APIs with no effort.</p>
<p align="center"><a href="https://strapi.io/demo">Try live demo</a></p>
2017-09-29 11:29:17 +02:00
<br />
2020-05-18 18:54:26 +02:00
2017-09-29 11:29:17 +02:00
<p align="center">
<a href="https://www.npmjs.org/package/strapi">
<img src="https://img.shields.io/npm/v/strapi/latest.svg" alt="NPM Version" />
2017-09-29 11:29:17 +02:00
</a>
<a href="https://www.npmjs.org/package/strapi">
<img src="https://img.shields.io/npm/dm/strapi.svg" alt="Monthly download on NPM" />
2017-09-29 11:29:17 +02:00
</a>
<a href="https://discord.strapi.io">
<img src="https://img.shields.io/discord/811989166782021633?label=Discord" alt="Strapi on Discord" />
2017-09-29 11:29:17 +02:00
</a>
</p>
2016-01-11 14:33:29 +01:00
2017-09-29 11:29:17 +02:00
<br>
2016-12-05 18:43:03 +01:00
2018-08-21 01:31:10 -07:00
<p align="center">
<a href="https://strapi.io">
<img src="https://raw.githubusercontent.com/strapi/strapi/master/public/assets/administration_panel.png" alt="Administration panel" />
2018-08-21 01:31:10 -07:00
</a>
</p>
2016-08-16 11:42:48 +02:00
2017-09-29 14:20:17 +02:00
<br>
2016-08-16 11:42:48 +02:00
2020-05-29 02:49:59 -07:00
Strapi is a free and open-source headless CMS delivering your content anywhere you need.
2019-05-31 13:46:00 +02:00
- **Keep control over your data**. With Strapi, you know where your data is stored, and you keep full control at all times.
- **Self-hosted**. You can host and scale Strapi projects the way you want. You can choose any hosting platform you want: AWS, Render, Heroku, a VPS, or a dedicated server. You can scale as you grow, 100% independent.
- **Database agnostic**. You can choose the database you prefer. Strapi works with SQL & NoSQL databases: MongoDB, PostgreSQL, MySQL, MariaDB, and SQLite.
- **Customizable**. You can quickly build your logic by fully customizing APIs, routes, or plugins to fit your needs perfectly.
2019-05-31 13:46:00 +02:00
2018-08-21 01:31:10 -07:00
## Getting Started
2017-07-26 17:16:44 +02:00
<a href="https://strapi.io/documentation/developer-docs/latest/getting-started/quick-start.html" target="_blank">Read the Getting Started tutorial</a> or follow the steps below:
2016-08-16 11:42:48 +02:00
### ⏳ Installation
Install Strapi with this **Quickstart** command to create a Strapi project instantly:
- (Use **yarn** to install the Strapi project (recommended). [Install yarn with these docs](https://yarnpkg.com/lang/en/docs/install/).)
```bash
yarn create strapi-app my-project --quickstart
```
**or**
- (Use npm/npx to install the Strapi project.)
```bash
npx create-strapi-app my-project --quickstart
```
This command generates a brand new project with the default features (authentication, permissions, content management, content type builder & file upload). The **Quickstart** command installs Strapi using a **SQLite** database which is used for prototyping in development.
Enjoy 🎉
### 🖐 Requirements
Complete installation requirements can be found in the documentation under <a href="https://strapi.io/documentation/developer-docs/latest/setup-deployment-guides/deployment.html#recommended-requirements">Installation Requirements</a>.
2019-05-31 15:25:41 +02:00
**Supported operating systems**:
2019-05-31 13:46:00 +02:00
- Ubuntu LTS/Debian 9.x
2019-05-31 15:25:41 +02:00
- CentOS/RHEL 8
2019-12-04 11:53:44 -08:00
- macOS Mojave
2019-05-31 15:25:41 +02:00
- Windows 10
2019-05-31 13:46:00 +02:00
- Docker - [Docker-Repo](https://github.com/strapi/strapi-docker)
2018-11-28 00:30:04 -07:00
2019-05-31 15:25:41 +02:00
(Please note that Strapi may work on other operating systems, but these are not tested nor officially supported at this time.)
2018-11-28 00:30:04 -07:00
2019-05-31 15:25:41 +02:00
**Node:**
2019-05-31 13:46:00 +02:00
2021-06-23 07:55:40 +02:00
- NodeJS >= 12 <= 16
2019-05-31 13:46:00 +02:00
- NPM >= 6.x
2019-05-31 15:25:41 +02:00
**Database:**
2019-05-31 13:46:00 +02:00
- MySQL >= 5.6
- MariaDB >= 10.1
- PostgreSQL >= 10
2019-05-31 15:25:41 +02:00
- SQLite >= 3
2019-05-31 15:25:41 +02:00
**We recommend always using the latest version of Strapi to start your new projects**.
## Features
- **Modern Admin Panel:** Elegant, entirely customizable and a fully extensible admin panel.
- **Secure by default:** Reusable policies, CORS, CSP, P3P, Xframe, XSS, and more.
2020-05-29 02:49:59 -07:00
- **Plugins Oriented:** Install the auth system, content management, custom plugins, and more, in seconds.
2019-05-31 15:25:41 +02:00
- **Blazing Fast:** Built on top of Node.js, Strapi delivers amazing performance.
- **Front-end Agnostic:** Use any front-end framework (React, Vue, Angular, etc.), mobile apps or even IoT.
- **Powerful CLI:** Scaffold projects and APIs on the fly.
2021-06-29 16:27:35 +02:00
- **SQL databases:** Works with PostgreSQL, MySQL, MariaDB, and SQLite.
2019-05-31 15:25:41 +02:00
**[See more on our website](https://strapi.io/overview)**.
2018-08-21 01:31:10 -07:00
## Contributing
2016-08-15 12:43:36 +02:00
2018-08-21 01:31:10 -07:00
Please read our [Contributing Guide](./CONTRIBUTING.md) before submitting a Pull Request to the project.
2015-10-01 00:30:16 +02:00
## Community support
2017-09-29 14:20:17 +02:00
For general help using Strapi, please refer to [the official Strapi documentation](https://strapi.io/documentation/). For additional help, you can use one of these channels to ask a question:
2015-10-01 00:30:16 +02:00
2021-05-26 00:11:12 -07:00
- [Discord](https://discord.strapi.io) (For live discussion with the Community and Strapi team)
- [GitHub](https://github.com/strapi/strapi) (Bug reports, Contributions)
- [Community Forum](https://forum.strapi.io) (Questions and Discussions)
2020-12-01 16:56:32 +01:00
- [Academy](https://academy.strapi.io) (Learn the fundamentals of Strapi)
2019-05-31 15:25:41 +02:00
- [ProductBoard](https://portal.productboard.com/strapi/tabs/2-under-consideration) (Roadmap, Feature requests)
- [Twitter](https://twitter.com/strapijs) (Get the news fast)
2019-05-31 15:25:41 +02:00
- [Facebook](https://www.facebook.com/Strapi-616063331867161)
- [YouTube Channel](https://www.youtube.com/strapi) (Learn from Video Tutorials)
2018-08-21 01:31:10 -07:00
## Migration
Follow our [migration guides](https://strapi.io/documentation/developer-docs/latest/update-migration-guides/migration-guides.html) on the documentation to keep your projects up-to-date.
2016-09-28 11:21:41 +02:00
2018-10-19 17:08:43 +02:00
## Roadmap
2019-05-31 15:25:41 +02:00
Check out our [roadmap](https://portal.productboard.com/strapi) to get informed of the latest features released and the upcoming ones. You may also give us insights and vote for a specific feature.
2018-10-19 17:08:43 +02:00
## Documentation
See our dedicated [repository](https://github.com/strapi/documentation) for the Strapi documentation, or view our documentation live:
- [Developer docs](https://strapi.io/documentation/developer-docs/latest/getting-started/introduction.html)
- [User docs](https://strapi.io/documentation/user-docs/latest/getting-started/introduction.html)
## Try live demo
See for yourself what's under the hood by getting access to a [hosted Strapi project](https://strapi.io/demo) with sample data.
2016-09-28 11:21:41 +02:00
## License
See the [LICENSE](./LICENSE) file for licensing information.