tinywidgets
v1.3.7
A collection of tiny, reusable, UI components - wrapped in a helpful app layout with header, side bar, dark mode, and more.
0/weekUpdated 7 months agoMITUnpacked: 270.2 KB
Published by jamesgpearce
npm install tinywidgetsTinyWidgets
A collection of tiny, reusable, UI components
— wrapped in a helpful app layout with header, side bar, dark mode, and more.
See the website for more details. Get started here.
---
Dependencies
TinyWidgets uses React for DOM manipulation, Vanilla-Extract at build-time for styling, Lucide for icons, and TinyBase for state management. Its philosophy is all about simplicity, decent defaults, a streamlined DOM, and concise styling.
But, just to be clear - that doesn't mean you need to use Vanilla-Extract, Lucide, or Tinybase in the apps you build with these widgets. You can set arbitrary class names (from Tailwind, for example!) on all components if you like.
Meet the family
TinyTick is part of a group of small libraries designed to help make rich client and local-first apps easier to build. Check out the others!
TinyBase
The reactive data store for local-first apps.
TinyWidgets
A collection of tiny, reusable, UI components.
TinyTick
A tiny but very useful task orchestrator.
Help out!
This project was created because I want to be able to build lots of local-first apps quickly and without the overhead of all the app boilerplate each time.
Making it open source seemed like the right thing to do, so please try and it out and get involved. I'll always be interested in issues, more style variants, new components altogether, or even some professional-grade design assistance. I'm not a designer...
See you on GitHub!
Installation
The easiest way to get started with TinyWidgets is to use its Vite template. This comes with the (simple) build configuration you need to work with TinyWidgets.
To create a new TinyWidgets application using this template, do the following:
1. Make a copy of this template into a new directory:
``sh`
npx tiged tinyplex/vite-tinywidgets my-tinywidgets-app
2. Go into the directory:
`sh`
cd my-tinywidgets-app
3. Install the dependencies:
`sh`
npm install
4. Run the application:
`sh`
npm run dev
5. The Vite server should start up. Go the URL shown and enjoy!
Note that you can also create a production build with npm run build`.