Skip to content

synergycodes/overflow-ui

Repository files navigation

A React library for creating node-based user interfaces and diagram-driven apps. Built to work seamlessly with React Flow, it provides a collection of ready-to-use components and templates that simplify the development of visual editors, workflows, and interactive diagrams.

Developed and maintained by Synergy Codes.

Quick Start: 3-Minute Guide

📦 Installation

Use one of the commands below to add Overflow UI to your project:

npm install @synergycodes/overflow-ui
pnpm add @synergycodes/overflow-ui
yarn add @synergycodes/overflow-ui

🎨 Import styles

Add to your style sheet or component:

@import '@synergycodes/overflow-ui/tokens.css';
import '@synergycodes/overflow-ui/tokens.css';

🌗 Set the theme

To make the styles use proper variables, include data-theme (light or dark) attribute in <html>:

<html data-theme="light">

🎛️ Use components

import { Input } from '@synergycodes/overflow-ui';

// …

<Input value={value} onChange={onChange} />;

Customization

Each Overflow UI component uses CSS variables that are derived from primitive values.

You can override them:

:root {
  --ax-ui-bg-primary-default: #40ba12;
}

or a derived value used by the selected component:

:root {
  --ax-public-date-picker-dropdown-background: #40ba12;
}

Overflow UI css layers

Overflow UI uses CSS layers to separate its styles from yours. By default, CSS styles outside of any layer take precedence over what Overflow UI defines, so your styles will always win the specificity war. You can customize Overflow UI components with simple input {}.

@layer ui.component {
  .separator {
    /* … */
  }
}

Default Overflow UI order:

@layer ui.base, ui.component;

If you want to use layers in your code, just add them at the end.

Showcase

Workflow Builder is a frontend-focused starter app for building workflows, offering core features, best practices, and easy backend integration for faster client delivery.

https://www.workflowbuilder.io/