title: Development Guide

The Dashboard contains both manager-api and web parts, so you need to start the development environment separately.

Prerequisites

Before development, refer to this guide to install dependencies.

Clone the project

$ git clone -b release/2.13 https://github.com/apache/apisix-dashboard.git

Start developing

$ cd apisix-dashboard

manager-api

  1. Please change the configuration in api/conf/conf.yaml.

  2. In the root directory, launch development mode.

$ make api-run
  1. In the root directory, stop development mode.
$ make api-stop
  1. Please refer to the FAQ about the problem of displaying exception in the dashboard after adding custom plugins or modifying plugin's schema.

  2. If writing an back end E2E test, please refer to the Back End E2E Writing Guide

web

  1. Go to the web directory.
$ cd ./web
  1. Please change the manager-api address in the config/defaultSettings.ts file. If you follow this guidelines, the address may need to be set as below.
serveUrlMap:{
    dev: 'http://localhost:9000'
}
  1. Launch development mode
$ yarn install

$ yarn start

If there is an error about gyp during yarn install, please ignore it and go ahead!

  1. If writing an front end E2E test, please refer to the Front End E2E Writing Guide