strapi/README.md

91 lines
2.7 KiB
Markdown
Raw Normal View History

# Strapi [![Build Status](https://travis-ci.org/wistityhq/strapi.svg?branch=master)](https://travis-ci.org/wistityhq/strapi)
2015-10-02 15:47:37 +02:00
[Website](http://strapi.io/) - [Getting Started](#user-content-getting-started-in-a-minute) - [Documentation](http://strapi.io/documentation) - [Support](http://strapi.io/support)
2015-10-01 00:30:16 +02:00
Strapi is an open-source Node.js rich framework for building applications and services.
2015-10-01 00:30:16 +02:00
Strapi enables developers to focus on writing reusable application logic instead of spending time
building infrastructure. It is designed for building practical, production-ready Node.js applications
in a matter of hours instead of weeks.
2015-10-01 00:30:16 +02:00
The framework sits on top of [Koa](http://koajs.com/). Its ensemble of small modules work
2015-10-01 00:30:16 +02:00
together to provide simplicity, maintainability, and structural conventions to Node.js applications.
## Getting started in a minute
### Installation
Install the latest stable release with the npm command-line tool:
2015-10-01 00:30:16 +02:00
```bash
$ npm install strapi -g
```
### Link to the Strapi Studio
> We advise you to use our Studio to build APIs. To do so, you need to create a Strapi account.
[Go to the Strapi Studio to signup](http://studio.strapi.io).
Studio is dedicated to developers to build applications without writing
any single line of code thanks to its powerful set of tools.
After creating an account on the Strapi Studio, you are able to link your machine to your
Strapi Studio account to get access to all features offered by the Strapi ecosystem.
Use your Strapi account credentials.
```bash
$ strapi login
```
### Create your first project
You now are able to use the Strapi CLI. Simply create your first application and start the server:
2015-10-01 00:30:16 +02:00
```bash
$ strapi new <appName>
```
### Start your application
```bash
2015-10-01 00:30:16 +02:00
$ cd <appName>
$ strapi start
```
The default home page is accessible at [http://localhost:1337/](http://localhost:1337/).
### Create your first API
2015-10-01 00:30:16 +02:00
The Strapi ecosystem offers you two possibilities to create a complete RESTful API.
2015-10-01 00:30:16 +02:00
#### Via the CLI
2015-10-01 00:30:16 +02:00
```bash
$ strapi generate api <apiName>
```
For example, you can create a `car` API with a name (`name`), year (`year`) and
the license plate (`license`) with:
2015-10-02 10:59:11 +02:00
```bash
$ strapi generate api car name:string year:integer license:string
```
2015-10-02 10:23:21 +02:00
#### Via the Strapi Studio
2015-10-02 10:34:00 +02:00
The Strapi Studio allows you to easily build and manage your application environment
thanks to a powerful User Interface.
2015-10-02 10:23:21 +02:00
Log into the Strapi Studio with your user account ([http://studio.strapi.io](http://studio.strapi.io))
and follow the instructions to start the experience.
2015-10-02 10:23:21 +02:00
2015-10-01 00:30:16 +02:00
## Resources
- [Roadmap](ROADMAP.md)
- [Contributing guide](CONTRIBUTING.md)
- [MIT License](LICENSE.md)
## Links
- [Strapi website](http://strapi.io/)
- [Strapi news on Twitter](https://twitter.com/strapijs)