diff --git a/README.md b/README.md index e3a56566e4..c203f20a18 100644 --- a/README.md +++ b/README.md @@ -2,49 +2,91 @@ [Website](http://strapi.io/) - [Getting Started](#user-content-getting-started-in-a-minute) - [Documentation](http://strapi.io/documentation) - [Support](http://strapi.io/support) -Strapi is a open-source Node.js rich framework for building applications and services. +Strapi is an open-source Node.js rich framework for building applications and services. 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, not weeks. +in a matter of hours instead of weeks. -Strapi is a framework that sits on top of [Koa](http://koajs.com/). Its ensemble of small modules work +The framework sits on top of [Koa](http://koajs.com/). Its ensemble of small modules work together to provide simplicity, maintainability, and structural conventions to Node.js applications. ## Getting started in a minute -To install the latest stable release with the npm command-line tool: +### Installation + +Install the latest stable release with the npm command-line tool: ```bash $ npm install strapi -g ``` -Strapi comes with a convenient command-line tool to quickly get your application scaffolded and running: +### 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: ```bash $ strapi new +``` + +### Start your application + +```bash $ cd $ strapi start ``` -At this point, if you visit [http://localhost:1337/](http://localhost:1337/) you will see the default home page. +The default home page is accessible at [http://localhost:1337/](http://localhost:1337/). -The admin dashboard is available at [http://localhost:1337/admin/](http://localhost:1337/admin/). +Strapi comes out of the box with an auto-generated admin panel, based on the models of your +application. This dashboard offers the opportunity to easily manage your data. You don't +need developer skills to use it. -Easily generate a complete API with controllers, models and routes using: +The local admin dashboard is available at [http://localhost:1337/admin/](http://localhost:1337/admin/). + +[![Strapi Admin Panel](http://strapi.io/assets/images/strapi-admin.jpg "Strapi Admin Panel")](http://strapi.io/documentation/admin) + +Note: On the first login, you'll be asked to create the first admin profile. + +### Create your first API + +The Strapi ecosystem offers you two possibilities to create a complete RESTful API. + +#### Via the CLI ```bash $ strapi generate api ``` -What's next ? Visit the [documentation](http://strapi.io/documentation) and give us your feedback on [Twitter](https://twitter.com/strapijs). +For example, you can create a `car` API with a name (`name`), year (`year`) and +the license plate (`license`) with: -## Admin panel +```bash +$ strapi generate api car name:string year:integer license:string +``` -Strapi comes out of the box with an auto-generated admin panel, based on the models of your application. +#### Via the Strapi Studio -[![Strapi Admin Panel](http://strapi.io/assets/images/strapi-admin.jpg "Strapi Admin Panel")](http://strapi.io/documentation/admin) +The Strapi Studio allows you to easily build and manage your application environment +thanks to a powerful User Interface. +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. ## Resources