@synergycodes/overflow-ui
v1.0.0-beta.22
Published
A React library for creating node-based UIs and diagram-driven applications. Perfect for React Flow users, providing ready-to-use node templates and components that work seamlessly with React Flow's ecosystem.
Readme
@synergycodes/overflow-ui
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-uipnpm add @synergycodes/overflow-uiyarn 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';🎛️ Apply the Theme
To make the styles use proper variables, include data-theme (light or dark) attribute in :
<html data-theme="light">🧱 Use components
import { Input } from '@synergycodes/overflow-ui';
// …
<Input value={value} onChange={onChange} />;Overview
Forget cobbling together UI kits with diagram libraries. Overflow UI provides a unified set of designed, ready-to-use components: buttons, inputs, accordions, node templates, and more — all built to work seamlessly together.
Features
- Unified Component System: Seamlessly integrated UI and diagram components
- Ready-to-use Components: Comprehensive set of pre-built components
- Token-based Customization: Easy theming through CSS variables
- Developer-friendly: Focus on developer experience and productivity
- React Flow Compatible: Perfect for React Flow users with pre-built node templates that match React Flow's styling
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;🛠️ Development
To develop and test components, follow these steps in monorepo root:
- Install dependencies:
pnpm i- Build UI:
pnpm ui build- Run preview page:
pnpm ui previewNow visit localhost:3000 to see every change in components reflected in the preview page.
Edit ui/preview-page/preview-page.tsx to display desired components.
📣 Important Note on Underlying Technology
Overflow UI is built on top of MUI Base, a headless component library that focuses on accessibility and logic, while leaving the styling up to us.
Thanks to MUI Base, Overflow UI provides components that are accessible by default and fully customizable through our design tokens.
We are aware that MUI Base has been deprecated, and the MUI team recommends migrating to Base UI. However, after careful evaluation, we've chosen to stay with MUI Base for now because:
- ✅ Base UI is not yet mature enough for our needs.
- ✅ We want to ensure a stable, well-tested experience for Overflow UI users.
This is a conscious and informed decision. We will continue to monitor Base UI's progress and will consider migrating when we feel it's the right time, ensuring a smooth and thoughtful transition for Overflow UI users.
If you have any questions or concerns, feel free to reach out — we’re happy to share our reasoning and plans in more detail!
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/