Skip to main content

Pick and theme charts with chartsy

Picks a fitting chart for a React, Tailwind, and shadcn project, installs it from bklit UI, and applies Chartsy palettes and author-rendered recipes.

Source facts

Repository
David-glitc/chartsy
Last source activity
November 13, 2026 at 13:57
Detected SKILL.md language
English
Stars
0
Forks
0

Uses

Use this Skill when adding or restyling a chart, graph, plot, sparkline, KPI tile, heatmap, funnel, sankey, gauge, or dashboard in a React project that already uses Tailwind and shadcn, or when you want the agent to pick a chart, install it, apply a Chartsy palette, or make existing charts look like one family. It is a design system for charts, not a component library of its own: components come from bklit UI. The Skill says it is not for non-React stacks, static image plots such as matplotlib or plotly, or maps, and that the agent should never hand-roll SVG charts or add recharts, chart.js, or visx when a bklit chart exists. The qualified post (https://x.com/davidpereIsHIM/status/2121242167238611406) is a same-author reply that says "15 charts with recipes i actually rendered" and "haven't run it on a clean repo with a fresh agent yet, so if it breaks for you tell me," and links to https://chartsy-bklit.pages.dev. The same author's parent post (2121242165447725189) is first-person context only, not a second card. A later same-author post (2121245276178379225) is a near-duplicate of this same path and remains deferred: it is not drafted and is not upgraded.

Prerequisites

You need a React project with Tailwind v4 and a shadcn components.json. If shadcn is missing, the Skill says to run npx shadcn@latest init first. components.json must include the bklit registry https://ui.bklit.com/r/{name}.json under @bklit; the agent adds it if it is absent. TypeScript projects need @types/d3-shape, @types/d3-scale, @types/d3-array, and @types/d3-sankey, or the installed chart files fail the typecheck. Charts are installed with npx shadcn@latest add @bklit/<item> and land in src/components/charts/; there is no barrel file, so each part is imported from its own file. The bklit docs path @bklitui/ui/charts does not exist in a registry install. Chartsy tokens are applied once per project after the first chart, preferably with npx shadcn@latest add https://chartsy-bklit.pages.dev/r/chartsy.json, or by copying assets/chartsy.css to the end of the global stylesheet. These registry and theme installs are Skill steps, not materials you must already have prepared. The repository's package.json and pnpm scripts belong to the Chartsy demo site and are not written as Skill requirements. Documented install commands were not executed in this draft.

How to use

Start from the question the reader is asking, not from the data shape, and pick a chart with the Skill's chart-picker table. If two charts fit, choose the simpler one. One chart answers one question. The fifteen charts in that table, matching the author post's "15 charts," are area, line, bar, candlestick, live line, scatter, radar, donut (the pie-chart item), ring, sunburst, gauge, sankey, funnel, heatmap, and sparkline. Install the chosen registry item, import each part from its own file under @/components/charts/, then apply Chartsy tokens once if they are not already in the project. If you have not named a palette, the agent picks by product tone from the palettes reference and says which one it chose. The default is Ember; the twelve palettes are Ember, Tide, Grove, Dusk, Neon, Citrus, Glacier, Terra, Orchid, Candy, Cobalt, and Ink. Other palettes install from https://chartsy-bklit.pages.dev/r/chartsy-<id>.json. Never hard-code hex colours; use var(--chart-1) through var(--chart-5). Copy the matching recipe from the recipes reference and replace the data, keeping the documented child order (grid, series, axes, tooltip). Every recipe there is stated by the Skill to have been built and rendered. Then apply the design rules: colour follows series order and stays consistent for the same entity; at most five series, or group the tail into "Other" or use small multiples; a title that states the takeaway and a one-line note with unit and period; horizontal grid only; time on the x axis is a Date, never a formatted string; legends under the chart, skipped for a single series; leave the entrance animation on, and do not add looping animation unless the data is live. Verify that typecheck and build pass, that the chart renders in light and dark and at desktop width and 390px, that hover shows a tooltip with the right labels and units, and that the parent has a real width (sizing is by aspectRatio, not parent height). The Skill's gotchas table covers known import, typing, grey-palette, ring, gauge, funnel, sankey, radar, live-axis, and sunburst failures. Documented commands were not executed.

Limitations

Chartsy is a design workflow for bklit UI charts in React, Tailwind CSS v4, and shadcn projects. It is not a chart library, map tool, or way to produce static matplotlib or Plotly images. Use the bklit component when one exists instead of adding a second chart library or drawing the chart by hand. Answer one question per chart, keep at most five series, and use theme tokens for colors. The author reports rendering 15 recipes and says the skill has yet to run end to end in a fresh project with a new agent. Registry installation requires network access. The repository is MIT licensed. Its NOTICE identifies MIT-licensed bklit UI components and attribution.

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
6 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
namechartsy
descriptionChart design system for React apps, built on bklit UI (shadcn registry, d3 + motion). Picks the right chart for the question, installs it from the @bklit registry, applies the Chartsy tokens (12 palettes, sequential scale, light and dark), and composes it from verified recipes. Use when adding or restyling any chart, graph, plot, sparkline, KPI tile, heatmap, funnel, sankey, gauge or dashboard in a React + Tailwind + shadcn project, or when asked to "add a chart", "visualize this data", "make this chart look better", "build a dashboard", "chart colors", "change the chart palette", or "use chartsy". Not for non-React stacks, static image plots (matplotlib, plotly), or maps.