Ogma styles

This is a repositiory of style presets for Ogma graph visualisation library. You can use them in your prototypes and applications.

Demo

Table of Contents

• How to use
  • Install
  • Usage
• Themes:
  • "Midsummer night" theme
    • Additional variables
    • Color palette
    • Compose your own style
  • "Afternoon nap" theme
  • "Morning breeze" theme
• Color Schemes
  • Available Color Schemes
  • Import and Usage
  • Color Scheme Characteristics
• Copyright

How to use

Install

npm install -S @linkurious/ogma-styles
# or
yarn add @linkurious/ogma-styles

Alternatively, you can use the CDN-hosted version

<script src="https://cdn.jsdelivr.net/npm/@linkurious/ogma-styles@0.0.4/dist/index.min.js"></script>
...
<script>
  // themes are globally exposed as `ogmaStyles`
  const themes = ogmaStyles;
</script>

Usage

import { Ogma } from '@linkurious/ogma';
import { midsummerNight as theme } from '@linkurious/ogma-styles'

const ogma = new Ogma({ ... });
ogma.styles.setTheme(theme);

"Midsummer night" theme

import { Ogma } from '@linkurious/ogma';
import { midsummerNight as theme } from '@linkurious/ogma-styles'

const ogma = new Ogma({
  ...
});

ogma.styles.setTheme(theme);

// you can also use the theme's colors for your UI
console.log(theme.colors.red); // '#df162e'

Additional variables

midsummer-night exports several constants for you to apply when you need conditional styling.

  edgeOutlineWidth: 2,
  edgeHaloWidth: 8,
  nodeHaloWidth: 20,

  // you can also use different colors for the nodes and edges
  colors: {}

Color palette

Compose your own style

You can follow the examples in src to create your own theme. The repositiory uses TypeScript for checking the types of attributes, so you will not get lost. You can always try out your theme in Ogma playground If you want to share it, send us a pull request and we will check and publish it.

"Afternoon nap" theme

import { Ogma } from '@linkurious/ogma';
import { afternoonNap as theme } from '@linkurious/ogma-styles'

const ogma = new Ogma({
  ...
});

ogma.styles.setTheme(theme);

// you can also use the theme's constants for your UI
console.log(theme.colors.nodeHaloWidth); // 40

"Morning breeze" theme

import { Ogma } from '@linkurious/ogma';
import { morningBreeze as theme } from '@linkurious/ogma-styles'

const ogma = new Ogma({
  ...
});

ogma.styles.setTheme(theme);

// you can also use the theme's constants for your UI
console.log(theme.colors.nodeHaloWidth); // 40

Color Schemes

The package includes a collection of carefully selected color palettes for data visualization, including Paul Tol's scientifically designed color schemes and custom categorical palettes.

Available Color Schemes

categorical - 9 distinct accessible colors for basic categorical data

#44AA99  #FFCB2F  #FF7523  #FF9AAC  #80E5CA  #0099FF  #1450DD  #9386CE
#617083

categorical16 - 16 colors for larger categorical datasets

#44AA99  #FFCB2F  #FF7523  #FF9AAC  #80E5CA  #0099FF  #1450DD  #9386CE
#617083  #E74C3C  #2ECC71  #F39C12  #8E44AD  #34495E  #16A085  #D35400

categorical24 - 24 colors for extensive categorical data

#44AA99  #FFCB2F  #FF7523  #FF9AAC  #80E5CA  #0099FF  #1450DD  #9386CE
#617083  #E74C3C  #2ECC71  #F39C12  #8E44AD  #34495E  #16A085  #D35400
#27AE60  #E67E22  #9B59B6  #3498DB  #F1C40F  #E91E63  #00BCD4  #795548

contrastLight - Paul Tol's bright color scheme (7 colors)

#4477AA  #66CCEE  #228833  #CCBB44  #EE6677  #AA3377  #BBBBBB

highContrast - Paul Tol's high-contrast scheme (4 colors)

#DDAA33  #BB5566  #004488  #000000

vibrant - Paul Tol's vibrant color scheme (7 colors)

#0077BB  #33BBEE  #009988  #EE7733  #CC3311  #EE3377  #BBBBBB

muted - Paul Tol's muted color scheme (9 colors)

#332288  #88CCEE  #44AA99  #117733  #999933  #DDCC77  #CC6677  #882255
#AA4499

mediumContrast - Paul Tol's medium contrast scheme (7 colors)

#EECC66  #EE99AA  #6699CC  #997700  #994455  #004488  #000000

pale - Paul Tol's pale color scheme (6 colors)

#BBCCEE  #CCEEFF  #CCDDAA  #EEEEBB  #FFCCCC  #DDDDDD

wong - Wong color scheme (8 colors)

#000000  #E69F00  #56B4E9  #009E73  #F0E442  #0072B2  #D55E00  #CC79A7

Import and Usage

import {
  categorical,
  categorical16,
  categorical24,
  contrastLight,
  vibrant,
  muted
} from '@linkurious/ogma-styles/colors';

// Use with Ogma node styling
ogma.styles.addNodeStyle({
  color: (node, index) => categorical[index % categorical.length]
});

// Use for custom color mapping
const nodeColors = categorical16.slice(0, myCategories.length);
ogma.styles.addNodeStyle({
  color: node => nodeColors[node.getData('category') % nodeColors.length]
});

// Access individual colors
console.log(vibrant[0]); // '#0077BB'
console.log(categorical24.length); // 24

Color Scheme Characteristics

• Categorical schemes are optimized for maximum visual distinction
• Paul Tol schemes are scientifically designed for accessibility and perceptual uniformity
• Wong scheme is colorblind-friendly
• All colors are provided as hex strings (e.g., '#44AA99')

Copyright

Linkurious SAS © 2025