Versions and compatibility
How Vadivam packages are versioned and released together, what every release is tested against, and how to verify a published package.
One version for every package
Every Vadivam package shares one version number: vadivam, the eight framework packages, and vadivam-mcp are released together from the same icon source. When you use more than one package, keep them on the same version, and upgrade them together.
Vadivam is before 1.0, so any release can change an API. Read the changelog before upgrading. It lists the icons added or redrawn and the package changes in each release.
Icon names follow the pinned Lucide release. A release that moves to a newer Lucide version can add icons and adopt Lucide’s renamed icons; see Categories and naming.
Tested in every release
A release is published only from a commit that passed the full test suite:
- Production builds of real apps that install the freshly built packages: Next.js, Vite with React, TanStack Start, Vue, Svelte, Solid, Angular, Astro, Preact, and a plain HTML page. The plain HTML, Vue, Svelte, Solid, Angular, Astro, and Preact apps are also served and checked in Chromium.
- React Native through an Expo app, exported for Android and iOS.
- React server rendering in a true server environment, with no DOM, alongside client rendering tests.
- The shadcn/ui registry, installed with the real
shadcnCLI into a fresh project. - The MCP server tools, over both stdio and HTTP.
- Every icon, against the rules in How icons are built.
The framework versions each package supports are listed under peer requirements.
Verify a package
Packages are published from GitHub Actions through npm Trusted Publishing, with no long-lived publish tokens. npm shows a provenance statement on each package page that links the published files to the release commit. In a project installed with npm install or npm ci (npm 9.5 or newer), check the installed packages’ signatures and provenance:
npm audit signaturesEach GitHub release also carries the matching Figma plugin build, and the MCP server’s entry in the MCP Registry is published from the same release.