create-adonisjs

Scaffold a new AdonisJS application using starter kits

Starter kits

You can use between one of the following official starter kits, or bring your own using the --kit flag.

api : AdonisJS application tailored for building HTTP APIs.
web : AdonisJS application tailored for building server-side rendered applications.
slim : Smallest possible AdonisJS application. Still way more powerful and batteries included than a express application.

Usage

# Using npm
npm init adonisjs

# Using yarn
yarn create adonisjs

# Using pnpm
pnpm create adonisjs

Options

`destination`

You can pass the destination directory as the first argument to the command. For example:

npm init adonisjs my-app

This argument is optional and the command will prompt you to enter the directory name if not provided.

Note - The directory must be empty otherwise the command will fail.

`--kit`

If you want to use your own starter kit hosted on Github, Gitlab, or Bitbucket, you can use the --kit flag to define the repo URL.

npm init adonisjs -- -K="github:github_user/repo"

# Download from GitLab
npm init adonisjs -- -K="gitlab:user/repo"

# Download from BitBucket
npm init adonisjs -- -K="bitbucket:user/repo"

You can also pass specify the branch or tag name as follows:

# Branch name
npm init adonisjs -- -K="github:github_user/repo#branch-name"

# Tag name
npm init adonisjs -- -K="github:github_user/repo#v1.0.0"

`--token`

If you are using a custom starter kit hosted on a private repository, then you can pass the authentication token as follows:

npm init adonisjs -- -K="github:github_user/repo" -t="github_token"

`--pkg`

We are trying to detect the package manager used by your project. However, if you want to force a specific package manager, then you can pass it as follows:

npm init adonisjs -- --pkg="yarn"

Other options

Option	Description
`--skip-install`	Skip installing dependencies.
`--skip-git-init`	Skip initializing git repository.

Contributing

One of the primary goals of AdonisJS is to have a vibrant community of users and contributors who believes in the principles of the framework.

We encourage you to read the contribution guide before contributing to the framework.

Code of Conduct

In order to ensure that the AdonisJS community is welcoming to all, please review and abide by the Code of Conduct.

License

create-adonisjs is open-sourced software licensed under the MIT license.

Xstoudi / create-adonisjs