moumen-soliman/lab

Moumenlab is a small collection of user interface components for React applications, built with Tailwind CSS and designed around the philosophy that "less is more." The repository offers everyday building blocks like menus, one-time password inputs, upload staging areas, and command palettes. Each component is built to do one specific thing well, and the project emphasizes animation that feels natural, with support for reduced-motion preferences. The installation approach sets this project apart from typical component libraries. Rather than adding a dependency that stays in your project at runtime, you copy the component source code directly into your codebase using a command-line tool. Running npx moumenlab add pulls the component files and their shared theme tokens into your project, giving you full ownership and the ability to modify the code as needed. This follows the shadcn registry pattern, and components can also be installed through the shadcn CLI directly. The project requires React 19, Tailwind CSS v4, and Node.js 18 or higher. The repository itself is structured as a monorepo managed with Turborepo and pnpm. It contains a showcase website built with Next.js where visitors can browse components, watch short looping video clips of each one in action, and explore live demos before installing. Component pages are statically generated from a registry file, and the same JSON payloads that the website displays are what the CLI uses for installation, keeping everything in sync. For developers who want to contribute, the project includes scaffolding commands that generate the starter files for a new component, including the installable source, a showcase page, and the registry wiring. The maintainer asks that contributors follow the included contributing guide and code of conduct. The project is open source under the MIT license and was created by Moumen Soliman.