component-sourcing
Skill0 starsChanged 52 days agoMITView on GitHub
Registry of vetted open source UI libraries for web products you ship yourself, with license gates and a normalization rule. Use whenever a UI need arises that a library might already solve: data table, chart, calendar, Kanban, Gantt, drag and drop, command palette, form validation, toast, modal, date handling, icons, animation, or an animated background. Also use before installing ANY new frontend dependency, before writing a component from scratch that sounds standard, and whenever asked which library to use or whether a library is safe to ship. Owns sourcing and licensing only; visual rules stay with landing-page-design.
In this repository2 other files it gives its agents.
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 32
Before adding anything to the registry below, check the source directly:
- Distinctive: line 61
All entries verified MIT unless noted.
- Distinctive: line 134
Run the license check above against the real repository, following any redirect.
- Distinctive: line 136
Add the row with its license and star count, and note the date checked if the license needed a fallback lookup.
- Distinctive: line 137
If it is blocked, record it in the blocked table with the reason.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Component sourcing
This skill answers two questions: what do I install, and am I allowed to ship it.
It does not decide how things look. Typography, spacing, radius, color, motion easing, and background rules all stay in landing-page-design. Both skills load together without conflict because they cover different layers: this one picks the raw material, that one shapes it.
Gate 1. License
The rule
MIT, Apache-2.0, BSD, and ISC only. Nothing else ships.
Anything outside that list is blocked until a license is read in full and the product owner approves it explicitly. Never assume, never infer from a blog post, never carry a license forward from memory.
Why copyleft is closed, even for our own products
Web products are served to users over a network. That is precisely the trigger condition for AGPL-3.0: the moment someone uses the product in a browser, the obligation to publish source code activates. "It's our own product, not a client's" does not create an exemption here. The only software AGPL is safe in is software nobody reaches over a network, and we ship nothing like that.
GPL and LGPL are lighter but still wrong for a frontend bundle, where everything gets compiled together and the boundary copyleft depends on stops being meaningful.
Verification procedure
Blog listicles and "best of" roundups are not evidence. They go stale, and repos get relicensed or transferred without the articles ever updating. Origin UI is the standing example: still recommended everywhere as a safe registry, while its actual repository moved and is now AGPL-3.0.
Before adding anything to the registry below, check the source directly:
curl -sSL "https://api.github.com/repos/OWNER/REPO" | python3 -c 'import sys,json;d=json.load(sys.stdin);print(d["full_name"],(d.get("license") or {}).get("spdx_id","NONE"),d["stargazers_count"])'Two failure modes to handle rather than trust:
NONEdoes not mean unlicensed. GitHub only reports a license it can auto-detect from a root LICENSE file. Fall back to the published package, which is what actually binds:curl -sSL https://registry.npmjs.org/PKG/latest | python3 -c 'import sys,json;print(json.load(sys.stdin).get("license"))'. This is the case withdate-fnstoday.- A redirect means the repo moved, and a moved repo may have been relicensed on the way. Follow it and re-read the license at the destination, never at the old name.
Gate 2. Normalization
Nothing gets pasted in as-is. Every absorbed component is rewritten onto our tokens before it ships:
- Colors come from the project's existing tokens. Never the library's palette.
- Radius follows the nesting formula in
landing-page-designB3. - Motion uses our cubic bezier from B7. Delete the library's default easing.
- Icons are swapped to Phosphor per B6, whatever the library shipped with.
- Spacing lands on our scale, not the library's arbitrary values.
The reason is blunt: paste from five libraries without this step and the page reads like a ransom note, five design languages arguing in one viewport. The component is raw material. The token contract is the product.
The registry
All entries verified MIT unless noted. Star counts are a rough liveness signal, not a ranking.
Foundation
| Need | Use | Notes |
| Component base | shadcn/ui (120.8k) | Source is copied into the repo, so we own it. The default starting point for all three products. |
| Accessible primitives | Radix Primitives (19.1k) | What shadcn is built on. Reach for it directly when a component needs behavior shadcn does not cover. |
| Unstyled primitives | Headless UI (28.7k) | Tailwind Labs. Alternative to Radix; do not mix both in one product, pick one per codebase. |
| Framework | Next.js (141.7k) | Already the standard across our products. |
Data and tables
| Need | Use | Notes |
| Data table | TanStack Table (28.3k) | Headless. Sorting, filtering, pagination, virtualization. The engine under shadcn's data-table. Core need for admin panels and data-heavy apps. |
| Server state | TanStack Query (50.1k) | Caching, refetch, optimistic updates. Stops hand-rolled useEffect fetching. |
| Charts | Recharts (27.5k) | Default. Composable and quick for dashboards. |
| Charts, custom | visx (21.0k) | Airbnb. Lower level, for when Recharts cannot express the form. Costs more time. |
Before drawing any chart: the dataviz-project skill picks the chart type, and the dataviz skill picks the colors and styling. This registry only says which library draws it.
Interaction
| Need | Use | Notes |
| Animation | Motion (33.2k) | Formerly Framer Motion. The single animation library; do not add a second. |
| Drag and drop | dnd-kit (17.5k) | Accessible, keyboard-operable. Sortable lists, Kanban. |
| Command palette | cmdk (12.9k) | Repo moved to dip/cmdk, still MIT. |
| Toast | sonner (12.8k) | Same author as much of the shadcn motion feel. |
| Kanban, Gantt, editors | Kibo UI (3.9k) | shadcn-compatible registry of the heavy composite components. Now under shadcnblocks/kibo. |
Forms
| Need | Use | Notes |
| Form state | react-hook-form (44.8k) | Uncontrolled by default, so large forms stay fast. |
| Validation | zod (43.4k) | Pairs with react-hook-form. Share the schema with the backend where the backend is TypeScript. |
Presentation
| Need | Use | Notes |
| Icons | Phosphor (1.7k, react package) | Mandated by landing-page-design B6. Solar and Iconamoon are the approved alternates. |
| Marketing motion | Magic UI (21.8k) | 150+ animated components for landing and marketing surfaces. Not for app interiors. |
| Animated backgrounds | beUI Studio (pro.beui.dev/studio) | Free, exports React source. Gated by landing-page-design B12: read it before shipping one. |
| Dates | date-fns (36.6k) | Repo has no LICENSE file; the npm package declares MIT. Tree-shakes, unlike moment. |
| Markdown to HTML | marked (37.1k) | GitHub reports NOASSERTION because the LICENSE file combines two licenses. Read in full 12 Sep 2026: MIT for marked, plus a BSD-3-Clause notice for Gruber's original Markdown. Both are allowed. npm declares MIT, with zero runtime dependencies. Use it at build time on trusted content only (Tarutha's legal pages). It does not sanitise, so never pass it user input. |
| CSS component layer | daisyUI (42.0k) | Only for a project not already on shadcn. Do not mix into a shadcn codebase, the two class philosophies fight. |
Blocked
| Library | Reason |
| Origin UI | Repository moved to cosscom/coss and is now AGPL-3.0. Network-served products cannot use it. Still listed as safe by most 2026 roundups, which is exactly why we verify at the source. |
| Aceternity UI | No public repository, no license stated on the site, and a paid tier. Status is unresolved, not approved. Do not copy from it until the license page is read in full and approved. |
Per product
Booking or admin SaaS. The weight sits in TanStack Table, TanStack Query, dnd-kit and Kibo. Marketing motion belongs only on the public marketing pages.
Financial data products. Tables and charts dominate: TanStack Table plus Recharts, dropping to visx only where a chart form genuinely demands it.
Consumer, mobile-first products where motion is the product (invitations, games). Motion plus Magic UI plus beUI backgrounds, all under the landing-page-design runtime contract.
Adding to this registry
- Run the license check above against the real repository, following any redirect.
- Confirm it is not solving a problem an entry above already solves. A second animation library or a second table engine is a net loss, not an addition.
- Add the row with its license and star count, and note the date checked if the license needed a fallback lookup.
- If it is blocked, record it in the blocked table with the reason. A blocked library with no reason gets re-proposed six months later by someone who does not remember why.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

