Back to search
react-mosaic
SkillGitHub
A React tiling window manager
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/nomcopter--react-mosaic)HTML
<a href="/listings/nomcopter--react-mosaic"><img src="/api/listings/nomcopter--react-mosaic/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npm install react-mosaic-component react react-dom
Import the stylesheet in your app's entry point:
import 'react-mosaic-component/react-mosaic-component.css';
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 124 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- [](https://www.npmjs.com/package/react-mosaic-component)
- [](https://reactjs.org/)
- [](https://www.typescriptlang.org/)
- <p align="center">
- <img alt="React Mosaic" src="./apps/website/static/img/favicon.svg" width="64px">
- </p>
- **react-mosaic** is a React tiling window manager. It gives you a drag-to-resize, drag-to-rearrange layout of panels that users can freely rearrange — inspired by IDE window management and i3-style tiling.
- **📖 [Documentation](https://nomcopter.github.io/react-mosaic/) · 🎮 [Demo](https://nomcopter.github.io/react-mosaic/demo) · 📚 [API reference](https://nomcopter.github.io/react-mosaic/docs/api) · 🚚 [Migration from v6](https://nomcopter.github.io/react-mosaic/docs/migration/from-v6)**
- [](./screencast.gif)
- ## Install
- ```bash
- npm install react-mosaic-component react react-dom
- ```
- Import the stylesheet in your app's entry point:
- ```tsx
- import 'react-mosaic-component/react-mosaic-component.css';
- ```
- ## Quick start
- ```tsx
- import { Mosaic, MosaicWindow } from 'react-mosaic-component';
- import 'react-mosaic-component/react-mosaic-component.css';
- export function App() {
- return (
- <div style={{ height: '100vh' }}>
- <Mosaic<string>
- renderTile={(id, path) => (
- <MosaicWindow<string> path={path} title={`Panel ${id}`}>
- <div style={{ padding: 20 }}>Contents of {id}</div>
- </MosaicWindow>
- )}
- initialValue={{
- type: 'split',
- direction: 'row',
- children: ['a', 'b'],
- }}
- />
- </div>
- );
- }
- ```
- To render it, mount `App` from your entry file as usual:
- ```tsx
- // main.tsx
- import { StrictMode } from 'react';
- import { createRoot } from 'react-dom/client';
- import { App } from './App';
- createRoot(document.getElementById('root')!).render(
- <StrictMode>
- <App />
- </StrictMode>,
- );
- ```
- The wrapper `div` needs a real height; `Mosaic` fills its parent, so a parent
- with no height gives you an empty page.
- That's a two-panel layout with a draggable divider, drag handles on each window title bar, and default toolbar buttons — in 15 lines.
- For live editable examples, the n-ary tree model, custom toolbars, tabs, theming, and the full API reference, see the **[documentation site](https://nomcopter.github.io/react-mosaic/)**.
- ## Features
- - **N-ary tree layouts.** A single split can hold any number of children, not just two.
- - **Tabs as first-class citizens.** Tab containers are a node type, not a bolted-on convention.
- - **Controlled or uncontrolled.** Pass `value` + `onChange` to manage the tree yourself, or `initialValue` to let the component own it.
- - **Drag-and-drop.** Built on `react-dnd` with HTML5 and touch backends.
- - **Theming.** Works with or without Blueprint; ships a default CSS theme plus CSS variables you can override.
- - **Zero-config migration.** Legacy v6 binary trees are auto-converted at render time. `convertLegacyToNary` is available for explicit upgrades.
- ## Using with AI coding agents
- The package ships an [Agent Skill](./skills/react-mosaic/SKILL.md) with the v7
- API, the tree model and the common mistakes (like writing the old v6
- `first`/`second` trees). It works with Claude Code, Codex, Cursor, GitHub
- Copilot, Gemini CLI and other agents that support skills:
- ```bash
- npx skills add nomcopter/react-mosaic
- ```
- Or point your agent at
- `node_modules/react-mosaic-component/skills/react-mosaic/SKILL.md`, e.g. from
- your `AGENTS.md` or `CLAUDE.md`. For chat assistants, the docs are also
- available as [llms.txt](https://nomcopter.github.io/react-mosaic/llms.txt) and
- [llms-full.txt](https://nomcopter.github.io/react-mosaic/llms-full.txt).
- ## Browser support
- Current versions of Chrome, Edge, Firefox and Safari, on desktop and mobile
- (touch drag and drop is built in). Internet Explorer is not supported. The
- package is published as modern JavaScript, so if you target older browsers,
- let your bundler transpile `react-mosaic-component` too.
- ## Contributing
- Contributions are welcome:
- - Clone and install: `npm install`
- - Start the docs site (hot-reloads the demo and live code blocks): `npm start`
- - Build the library: `npm run build:lib`
- - Run tests: `npm test`
- - Lint: `npm run lint`
- Issues and pull requests: [github.com/nomcopter/react-mosaic](https://github.com/nomcopter/react-mosaic)
- ## License
- Apache License 2.0 — see [LICENSE](./LICENSE).
- Originally developed by Kevin Verdieck at Palantir Technologies, Inc.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.