{"id":14590,"library":"fuma-cli","title":"Fuma CLI","description":"Fuma CLI is an early-stage command-line interface tool designed to facilitate the creation of custom component libraries, drawing inspiration from the `shadcn/ui` pattern. It aims to provide developers with a framework to build their own `shadcn/ui`-like CLI experience for their projects. Currently at version 0.0.5, the project is undergoing rapid development, as indicated by frequent patch releases. Its primary differentiator is its focus on extensibility, allowing users to define and manage their own UI component collections through a dedicated CLI. The project's current status suggests a focus on core features like component addition and environment detection, with a potential for significant changes as it approaches a stable release, serving as a foundational layer for customizable UI tooling.","status":"active","version":"0.0.5","language":"javascript","source_language":"en","source_url":"https://github.com/fuma-nama/fuma-cli","tags":["javascript"],"install":[{"cmd":"npm install fuma-cli","lang":"bash","label":"npm"},{"cmd":"yarn add fuma-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add fuma-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"fuma-cli is primarily a command-line tool, not designed for direct programmatic import in typical application code. Interaction is through the shell.","wrong":"import fuma from 'fuma-cli'","symbol":"fuma","correct":"npx fuma-cli"},{"note":"The 'add' functionality is exposed via the CLI command. Direct `import { add }` is not the intended usage for the main `fuma-cli` package.","wrong":"import { add } from 'fuma-cli'","symbol":"fuma add","correct":"npx fuma-cli add <component-name>"}],"quickstart":{"code":"npx fuma-cli init my-component-library\ncd my-component-library\necho 'console.log(\"Hello from a new component!\");' > src/components/hello-world.js\nnpx fuma-cli add hello-world --output-path components/ui\n\n# Example of running an interactive prompt (requires @fuma-cli/interactive)\n# Note: This is a conceptual demonstration as `fuma-cli add` is likely interactive by default now.\nnpx fuma-cli add","lang":"javascript","description":"Initializes a new Fuma CLI project, creates a sample component, and adds it to the project using the CLI's `add` command."},"warnings":[{"fix":"Always pin exact versions (e.g., `\"fuma-cli\": \"0.0.5\"`) and review the GitHub repository for the latest changes and upgrade guides before updating.","message":"As a pre-1.0 package (currently 0.0.5), `fuma-cli` is subject to frequent and undocumented breaking changes. API surfaces, configuration formats, and command-line arguments may change without major version bumps.","severity":"breaking","affected_versions":">=0.0.1"},{"fix":"Consult the (currently missing) official documentation or GitHub issues for clarification on its intended use cases and architecture before committing to it for production.","message":"The project description mentions 'Build your own Shadcn CLI', implying that `fuma-cli` itself might be a framework for building other CLIs, rather than a direct replacement for `shadcn/ui`. Users should understand its role as a meta-CLI tool.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Monitor the official GitHub repository for updates to documentation and examples. Engage with the maintainers via issues for specific guidance.","message":"Lack of comprehensive README and documentation makes understanding advanced features, customization options, and best practices challenging. Many aspects will require inspecting source code or trial-and-error.","severity":"gotcha","affected_versions":">=0.0.1"}],"env_vars":null,"last_verified":"2026-04-19T00:00:00.000Z","next_check":"2026-07-18T00:00:00.000Z","problems":[{"fix":"Use `npx fuma-cli <command>` to execute it without global installation, or install it globally with `npm install -g fuma-cli` (though `npx` is generally preferred for CLIs).","cause":"The `fuma-cli` package is not installed globally or locally in a way that makes its executable accessible in your PATH.","error":"fuma-cli: command not found"},{"fix":"Ensure that all transitive dependencies are correctly installed. Try `npm install` or `yarn install` in your project root. If using `npx`, ensure your `node_modules` is up-to-date. This might also indicate an issue with the package's bundled dependencies.","cause":"While `fuma-cli` is the main package, it appears to have sub-packages like `@fuma-cli/interactive` that it depends on, which might not be correctly installed or resolved in some environments.","error":"Error: Cannot find module '@fuma-cli/interactive'"}],"ecosystem":"npm"}