Skip to content

svecosystem/paneforge

Repository files navigation

PaneForge

npm version npm downloads license

PaneForge provides components that make it easy to create resizable panes in your Svelte apps. It's designed to be simple to use, and to work well with other Svelte components and libraries. This project has taken a lot of inspiration and code from the work done by Bryan Vaughn and react-resizable-panels and seeks to provide a similar experience for Svelte developers.

Features

  • Simple API: PaneForge is designed to be easy to use. It provides a small set of components that can be combined to create complex layouts.
  • Resizable Panes: Panes can be resized by dragging the resizer between them.
  • Nested Groups: Groups of panes can be nested inside other groups to create complex layouts.
  • Customizable: The appearance and behavior of the panes can be customized using CSS and Svelte props.
  • Persistent Layouts: PaneForge can be used with LocalStorage or cookies to persist the layout of the panes between page loads.
  • Accessible: PaneForge is designed to be accessible to all users, including those who use assistive technologies.
  • Community-driven: PaneForge is an open-source project that welcomes contributions from the community. If you have an idea for a new feature or an improvement, we'd love to hear from you!

Installation

npm install paneforge

Basic Usage

Here's a simple example of how to use Paneforge to create a horizontal pane group with two panes:

<script lang="ts">
	import { PaneGroup, Pane, PaneResizer } from "paneforge";
</script>

<PaneGroup direction="horizontal">
	<Pane defaultSize={50}>Pane 1</Pane>
	<PaneResizer />
	<Pane defaultSize={50}>Pane 2</Pane>
</PaneGroup>

The PaneGroup component is used to initialize a pane group, and the Pane component is used to create a pane. The PaneResizer component is used to create a resizer that can be dragged to resize the panes.

The components ship only with the styles necessary to position the panes in the appropriate layout. The rest of the styling is up to you.

For more information, see the Documentation.

Sponsors

This project is supported by the following beautiful people/organizations:

Logos from Sponsors

License

Published under the MIT license. Made by @huntabyte and community 💛

Community

Join the Discord server to ask questions, find collaborators, or just say hi!

Svecosystem Discord community