mirror of
https://github.com/strapi/strapi.git
synced 2025-09-27 01:09:49 +00:00
Improve wording and steps to get started
This commit is contained in:
parent
a843b5e4b2
commit
cffe240a6b
66
README.md
66
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)
|
[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
|
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
|
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.
|
together to provide simplicity, maintainability, and structural conventions to Node.js applications.
|
||||||
|
|
||||||
## Getting started in a minute
|
## 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
|
```bash
|
||||||
$ npm install strapi -g
|
$ 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
|
```bash
|
||||||
$ strapi new <appName>
|
$ strapi new <appName>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Start your application
|
||||||
|
|
||||||
|
```bash
|
||||||
$ cd <appName>
|
$ cd <appName>
|
||||||
$ strapi start
|
$ 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/).
|
||||||
|
|
||||||
|
[](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
|
```bash
|
||||||
$ strapi generate api <apiName>
|
$ strapi generate api <apiName>
|
||||||
```
|
```
|
||||||
|
|
||||||
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
|
||||||
|
|
||||||
[](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
|
## Resources
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user