This repo contains the source code of adonisjs.com. Feel free to clone this repo and run docs on your local.

Start by cloning this repo using the following command.

git clone https://github.com/adonisjs/adonisjs.com.git

The docs ( markup files ) are referenced as submodules, so make sure to clone the submodules too.

git submodule init 
git submodule update

Next, install the dependencies from npm.

npm install

After that copy the .env.example file as .env and make required changes.

The server is started using the adonis serve command.

adonis serve --dev

The docs are compiled at runtime, which means there is no build process to run the website.

But, a menu file is generated to create the sidebar in the docs view. For that, you have to run following command.

adonis compile:docs -v 4.0

The -v flag takes the version for which the menu file should be generated.

Also you can watch for changes, so that the menu file is re-generated everytime you change something.

adonis compile:docs -v 4.0 --watch

All of the styles are saved inside resources/sass folder, make sure do not edit the css files inside public directory and work sass files only.

npm run compile:styles

# with watcher
npm run styles

The scripts are compiled using webpack, and saved inside resources/scripts folder.

npm run compile:scripts

# with watcher
npm run scripts

The fonts referenced from Typekit are only to be used when you are developing website on local, deploying the website on different domain will make the fonts fail and is also not recommended.