# Getting started

## Create a new project

To create a new Puro application, first install [Puro Command-line Interface](https://github.com/puro-framework/puro-cli) on your system:

```
$ yarn global add @puro/cli
```

Once installed, you can create a new project by running:

```
$ puro create-project <targetDir>
```

Move to the target directory and create a new configuration file from the existing template:&#x20;

```
$ cp config/params.json.dist config/params.json
```

{% hint style="warning" %}
Make sure to have installed the right database driver accordingly with the [TypeORM's documentation](https://github.com/typeorm/typeorm#installation).
{% endhint %}

Finally you can launch the application with:

```
$ yarn migrate
$ yarn start
```

And trying it out with your client:

```
$ curl \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{ "title": "Title 1", "description": "Description 1" }' \
  --fail \
  http://127.0.0.1:8080/api/books
```

```javascript
{
  "status": 201,
  "content": "The book has been created."
}
```

![](https://3191429900-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LTECKzWW0GD7SYs6IyL%2F-LTKViZx4qQeZIp-ymBG%2F-LTKVqrWZ-7xleel4Pb5%2Flogo-stretch-small.png?alt=media\&token=2dc61440-0a48-49b9-8304-c1ba5b62e7d5)