Skip to content

Getting Started

This section will help you build first NightVision chart from ground up. You'll need a basic knowledge of javascript and the npm ecosystem.

WARNING

NightVision is currently in an active development state, the API is not finalized. However, it is already suitable for displaying candlestick / time-series data.

Step 1: Create a new Vite project

This will create a new directory night-vision-101 with a vanilla-js Vite template:

sh
# npm 6.x
npm create vite@latest night-vision-101 --template vanilla

# npm 7+, extra double-dash is needed:
npm create vite@latest night-vision-101 -- --template vanilla

# yarn
yarn create vite night-vision-101 --template vanilla

# pnpm
pnpm create vite night-vision-101 --template vanilla

Run the following commands to install it:

sh
cd night-vision-101
npm install

Step 2: Install NightVision package

sh
npm i night-vision

Step 3: Make your first chart

Replace the content of main.js in the root folder with:

js
import './style.css'
import { NightVision } from 'night-vision'

document.querySelector('#app').innerHTML = `
<style>
body {
    background-color: #0c0d0e;
}
</style>
<h1>Night Vision Charts</h1>
<div id="chart-container"></div>
`
// Generate some random data
function data() {
    return Array(30).fill(1).map((x, i) => [
        new Date(`${i+1} Nov 2022 GMT+0000`).getTime(),
        i * Math.random()
    ])
}
let chart = new NightVision('chart-container')
chart.data = {
    panes: [{
        overlays: [{
            name: 'APE Stock',
            type: 'Spline',
            data: data(),
            settings: {
                precision: 2
            }
        }]
    }]
}

And run:

sh
npm run dev

Voila! The chart is live.

TIP

Here and in the rest of the guide you can try examples directly in your browser.

What's next?

Now that you know how easy it is to create a great simple chart, we can move towards making mega-charts, packed with various indicators and custom overlays. First, we will learn about the main component configuration, then will study the chart internals and finally will dive into overlay-creation API and real-world charts.

Released under the MIT License.