Dependency-Track Front-End

The Front-End is a Single Page Application (SPA) used in Dependency-Track, an open source Supply Chain Component Analysis platform. The project is built with:

Vue 2.x / CLI 3.x
Bootstrap Vue
CoreUI

Build Setup

# Install dependencies
npm install

# Serve with hot reload at localhost:8080
npm run serve

# Build for production with minification
npm run build

# Run linter
npm run lint

# Generates a CycloneDX software bill-of-materials
npm run bom

Development Setup

In order to test with a Dependency-Track instance, the .env.development file needs to be modified and the VUE_APP_SERVER_URL property updated to reflect the base URL of a Dependency-Track server.

Deployment Options

Default Deployment

By default, the front-end is deployed to and accessible from the Dependency-Track server.

n-Tier Deployment

The front-end may optionally be deployed to a general purpose web server (e.g. NGINX or Apache). To configure the front-end for this scenario, simply change the value of API_BASE_URL in static/config.json.

{
  "API_BASE_URL": "https://drack-server.example.com"
}

Internationalization (i18n)

This project supports internationalization. Currently on English language is supported. Pull requests to support additional languages are encouraged.

Note to developers: Textual labels are defined in src/i18n/messages.json. Ensure that all labels are defined here and that components use i18n, not textual labels directly.

Copyright & License

Permission to modify and redistribute is granted under the terms of the Apache 2.0 license. See the LICENSE file for the full license.

Tlopasha/frontend