grasscn

Pixel-perfect Minecraft UI components for the web. Copy, customize, and build on them. Built on shadcn/ui. Open source.

Quick start

Add a Minecraft button to your shadcn-ready project:

npx shadcn@latest add https://grasscn.dev/r/button.json

Or with Bun:

bunx --bun shadcn@latest add https://grasscn.dev/r/button.json

import { Button } from "@/components/ui/button";

export default function Example() {
  return <Button>Back to Game</Button>;
}

Custom folder

To install into a separate folder, add --path:

npx shadcn@latest add https://grasscn.dev/r/button.json --path src/components/minecraft

Then use the matching import (assuming @/* maps to src/*):

import { Button } from "@/components/minecraft/button";

Documentation

Visit grasscn.dev/docs to explore the components and get started.

Contributing

Found a bug or have an idea? Open an issue.

Maintainer lint and format scope is centralized in tooling-scope.ts. External skill packages pinned in skills-lock.json, plus their .claude/skills mirrors, are vendored and retain their installed bytes. Unlocked project skills such as port-minecraft-ui remain checked; vendored skills are separate from generated code.

License

Licensed under the MIT license.