rubenhassid1/grenade

What this is

Grenade is a README-only prompting guide for getting Claude to produce plain HTML artifacts that a business reader can understand quickly. Instead of a document, dashboard tiles or chat reply, it asks Claude to pick a form from the reader's job: decision page, report, dashboard, step-by-step guide, slides, tool or one-page cheat sheet. The guide targets people who send Claude outputs to colleagues, managers or clients and want the page to stand on its own.

The repository contains no application code; the deliverable is the instruction set itself, with a style kit and a set of example pages README.

How to use it

You do not install anything. Add your notes or files to a Claude chat and send a prompt that points Claude at the guide:

Make an HTML page about [YOUR TOPIC] for [WHO WILL READ IT]. Follow github.com/rubenhassid1/grenade

Claude then builds a plain HTML artifact following the rules: identify the reader and the job first, choose a matching layout, show data visually, keep the first screen self-contained, and avoid the listed "slop" patterns. Say "HTML page" explicitly or Claude may produce a plain document prompt examples. To repair an existing page, attach it and ask Claude to fix the artifact following the same guide fix prompt.

The README also defines a web version built with Vite, React, TypeScript, Tailwind and shadcn/ui, deployed to Vercel behind a passcode gate web version. That path asks Claude to push to a private GitHub repository and deploy; it requires free GitHub and Vercel accounts account requirements.

What you get

The README includes a concrete style kit (Claude-like colors, five font sizes, card and button styles), form-selection table, design rules, anti-pattern checklist and pre-delivery check. Seven sample pages illustrate the intended output, including a decision page, monthly report, dashboard, step-by-step guide, slides, tool and cheat sheet, plus a before/after dashboard fix before and after.

Constraints and limits

The guide is written for Claude and relies on Claude following long, detailed instructions; results depend on the model and the prompt. The web version assumes Claude Code, GitHub CLI and Vercel CLI access and deploys with a passcode held in an environment variable. The README is free to use under an MIT license as stated, though GitHub reports the license as NOASSERTION README. There is no package, library or API to integrate into other software.

HotRepo's take

Grenade appeared in HotRepo's new-project list on 2026-11-03, gaining 15 stars and 1 fork over a roughly one-hour observation window from 13:45 to 14:45 UTC, reaching 117 stars and 23 forks. That is a single short snapshot, so it supports the fact of an early burst rather than a trend. The project is a prompt-engineering artifact rather than code, and its value is concentrated in the README rules and the linked examples, which readers can inspect before deciding whether to adopt the workflow.