Contribute on GitHub.
Tessli has no accounts and no forms of its own. Every way to contribute ends in a GitHub issue or pull request, where GitHub’s sign-in and moderation apply and the discussion stays public.
Suggest a source
For anyone with a good design or frontend link.
The issue form asks for the name, URL, category and access, what someone will find there, why it belongs next to one to three sources already in Tessli, and your relationship to it.
What happens next An issue labelled source:suggestion. An automated comment checks the URL for duplicates and whether it opens; a maintainer opens the source and decides.
Submit a design
For designers with a component, section or page.
Share a screenshot or a Figma link, the problem it solves and what the common default gets wrong. Only share work you made or have the right to share.
What happens next An issue labelled design:needs-implementation that a developer can pick up. If it becomes an item, the designer and the developer are both credited.
Contribute an item
For developers who want to add to the library.
Copy the item template, build the item with shadcn/ui primitives and semantic tokens, and fill in its taste notes honestly: use when, avoid when, the rules it follows and the default it replaces. Building a submitted design or a good first issue is a good place to start.
What happens next A pull request. CI checks the notes, the build and the preview in three themes and at five widths; then a maintainer reviews it.
Report a problem
For a broken link, wrong information or a bug.
Report a listed source that is broken, has moved or should be archived, or anything on this site that does not work as expected.
What happens next An issue. Sources are never deleted silently: one that should go is archived with a reason, so its history and old links survive.
The rules, in short.
Maintainers enforce these in review. Contributions are released under the MIT licence; the Tessli name, wordmark and hero artwork are not part of it.
- Original work only.
- No ports or recreations of paid kits such as Tailwind Plus or shadcnblocks; their licences forbid it. Adapted open-source work names its source and licence.
- Disclose AI assistance.
- It is allowed, but say so in the issue or pull request, and a person must have reviewed the result. Unreviewed AI-generated work is rejected.
- No invented proof.
- No made-up metrics, ratings, customer logos or testimonials, in demo content or anywhere else. Fictional content looks clearly fictional.
- Sign off your commits.
- Tessli uses the Developer Certificate of Origin instead of a CLA: commit with git commit -s.