Build Terminal Apps with Giggles Framework

Terminal app development often feels like solving a puzzle—until you meet Giggles. This batteries-included React framework simplifies building TUIs (Terminal User Interfaces) by handling focus, navigation, and theming automatically. Inspired by Charmbracelet, Giggles lets you focus on what matters: creating intuitive command-line apps without the boilerplate.

Why Choose Giggles for Your TUI?

Traditional terminal app frameworks force you to manage input routing, keybindings, and screen transitions manually. Giggles changes the game with a component-driven architecture that feels familiar to React developers. From text inputs to virtual lists, everything works seamlessly out of the box.

Key Features That Stand Out

• Component-Specific Keybindings: Each UI element (like a text input inside a panel) manages its own keys. No global handlers needed.
• Navigation Made Simple: Switch between views effortlessly. Giggles restores focus to the right component when you return.
• Rich Component Library: Includes autocomplete, markdown rendering, and virtual lists for large datasets.
• Terminal Utilities: Spawn processes, stream output, or hand control to external tools like Vim with useShellOut and useSpawn.

Getting Started in Minutes

Begin with a single command: npx create-giggles-app. The framework handles the setup, letting you dive into building. Explore the official documentation for API references and live demos.

Customization and Control

While Giggles provides a polished default theme, you can tweak colors, fonts, and layouts via a single theme object. Need advanced control? Hooks like useFocusScope and useTerminalSize give you granular access to focus states and terminal dimensions.

Real-World Applications

Whether you’re building a CLI tool, a dev dashboard, or a productivity app, Giggles streamlines the process. For example, the CommandPalette component lets users search and execute commands instantly, while Viewport ensures smooth scrolling for large datasets.

Start Building Better TUIs

Terminal apps don’t have to be clunky or hard to maintain. With Giggles, you get a modern React-based workflow that scales. Try it today and see how much faster you can ship command-line tools.

Frequently Asked Questions

What is Giggles best for?

It excels at building interactive terminal apps with complex UIs, like dev tools, dashboards, or productivity utilities.

Can I use existing React skills with Giggles?

Yes! The framework uses React’s component model and hooks, making it easy for developers already familiar with the ecosystem.

How does Giggles handle large datasets?

The VirtualList component renders only visible items, optimizing performance for big data sets.

Is theming possible?

Absolutely. Customize colors, fonts, and spacing using the theme object in your app’s configuration.

Can I integrate external tools?

Use useShellOut to hand control to Vim or Less, then reclaim it cleanly when done.