create-adonisjs
v2.4.0
Published
Scaffold new AdonisJS applications using starter kits
Downloads
2,098
Readme
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.inertia
: AdonisJS application tailored for building applications using InertiaJS and your favorite frontend framework (Vue, React, Svelte, Solid).
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
(Default: Triggers prompt for selection)
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.
# Download from GitHub
npm init adonisjs -- --kit="github:github_user/repo"
# Github is the default provider, so if not specified, it will be assumed as github
npm init adonisjs -- --kit="github_user/repo"
# Download from GitLab
npm init adonisjs -- --kit="gitlab:user/repo"
# Download from BitBucket
npm init adonisjs -- --kit="bitbucket:user/repo"
You can also pass specify the branch or tag name as follows:
# Branch name
npm init adonisjs -- --kit="github:github_user/repo#branch-name"
# Tag name
npm init adonisjs -- --kit="github:github_user/repo#v1.0.0"
--token
(Default: undefined)
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 -- --kit="github:github_user/repo" --token="github_token"
--pkg
(Default: Auto detects)
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"
--auth-guard
(Default: Triggers prompt for selection)
Specify a custom auth guard to use when using the api
stater kit. One of the following options are allowed
session
access_tokens
npm init adonisjs -- --kit="api" --auth-guard="access_tokens"
--db
(Default: Triggers prompt for selection)
Specify the database dialect to configure with Lucid. One of the following options are allowd.
sqlite
mysql
mssql
postgres
npm init adonisjs -- --kit="web" --db="mysql"
Other options
| Option | Description |
| ------------ | --------------------------------------- |
| --git-init
| Initialize git repository. |
| --verbose
| Enable verbose mode to display all logs |
Debugging errors
If creating a new project fails, then you must re-run the same command with the --verbose
flag to view all the logs.
npm init adonisjs -- --verbose
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.