LaravelPackages.net
Acme Inc.
Toggle sidebar
vinix/ui

Vinix UI — shared design system & Blade component library for Laravel. One theme, every product.

7
0
v1.3.1
About vinix/ui

vinix/ui is a Laravel package for vinix ui — shared design system & blade component library for laravel. one theme, every product.. It currently has 0 GitHub stars and 7 downloads on Packagist (latest version v1.3.1). Install it with composer require vinix/ui. Discover more Laravel packages by vinix or browse all Laravel packages to compare alternatives.

Last updated

Vinix UI

npm Packagist License: MIT CSS size No dependencies

Shared design system & component library for Vinix Infotech products — one theme, every product. Ships from a single source to npm (pure JS / HTML) and Composer (Laravel Blade). Plain, self-contained CSS driven by CSS variables — no framework required — plus ~2 KB of dependency-free vanilla JS.

Ported from the DealSync360 design system. Navy + blue, clean SaaS/ERP look. 40+ components, a full token system, dark mode, and a responsive app shell.

Documentation

📖 Docs site: https://vinix-infotech-pvt-ltd.github.io/vinix-ui/ · source in docs/.

| Guide | What's inside | |-------|---------------| | Getting Started | Install & setup for npm and Composer/Laravel, CDN quick-start, verify-it-works. | | Component Reference | Every component — plain HTML/CSS and <x-vx-*> Blade usage, variants, props. | | Theming & Tokens | The --vx-* tokens, per-product re-brand, dark mode, Tailwind preset. | | JavaScript & Behaviors | window.VinixUI API, all data-vx-* behaviors, and emitted events. | | Live Gallery | Rendered catalogue of every component (open in a browser). |

Quick start

npm — pure JS / HTML / bundlers

npm install @vinixinfotech/ui
<link rel="stylesheet" href="node_modules/@vinixinfotech/ui/dist/vinix-ui.css">
<script src="node_modules/@vinixinfotech/ui/dist/vinix-ui.js"></script>

<body class="vx">
  <button class="vx-btn vx-btn-primary">Save</button>
  <span class="vx-badge vx-badge-live">LIVE</span>
</body>

In a bundler: import '@vinixinfotech/ui/css'; and import VinixUI from '@vinixinfotech/ui';

CDN (prototypes) — via jsDelivr from a tag:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/Vinix-Infotech-Pvt-Ltd/[email protected]/dist/vinix-ui.css">
<script src="https://cdn.jsdelivr.net/gh/Vinix-Infotech-Pvt-Ltd/[email protected]/dist/vinix-ui.js"></script>

Composer — Laravel Blade

composer require vinix/ui
php artisan vendor:publish --tag=vinix-ui-assets   # -> public/vendor/vinix-ui/
<link rel="stylesheet" href="{{ asset('vendor/vinix-ui/vinix-ui.css') }}">
<script src="{{ asset('vendor/vinix-ui/vinix-ui.js') }}" defer></script>

<x-vx-button variant="primary">Save</x-vx-button>
<x-vx-stat-card label="Total Saudas" value="426" trend="▲ 12%" trend-dir="up" />
<x-vx-badge variant="live">LIVE</x-vx-badge>
<x-vx-card title="Recent"> … </x-vx-card>
<x-vx-input label="Party name" name="name" required />

Full walkthrough (bundlers, all publish tags, verification): Getting Started.

Theming

Re-brand a product by overriding a few variables after the stylesheet:

:root{ --vx-accent:#6D28D9; --vx-accent-hover:#5B21B6; --vx-primary-600:#7C3AED; }

Same layout & components, different brand colour. Dark mode — opt in on any ancestor:

<html data-vx-theme="dark">   <!-- or class="vx-dark" on any wrapper -->

The token-driven components flip automatically; re-branding still applies in both themes. Details: Theming & Tokens.

What's included

  • Tokens — colours, type scale, radii, shadows (--vx-*) + a full dark theme.
  • 40+ components — navbar (responsive), button, card (+ outlined/interactive), stat-card, badge, table, input, select, textarea, label, range, file dropzone, input-group, combobox, multiselect, datepicker, alert, section-divider, dropdown, modal, drawer, popover, tabs, accordion, tooltip, switch, checkbox, radio, spinner, chip, progress, segmented control, stepper, timeline, list, avatar (+ group), skeleton, empty-state, breadcrumb, pagination, toast.
  • Typography utilities.vx-h1.vx-h4, .vx-text-muted, .vx-link, .vx-mono.
  • Responsive app shell — header bar, nav tabs, quick panel, bottom status bar, with a mobile nav toggle and off-canvas quick panel.
  • Vanilla JS (window.VinixUI) — navbar (mobile drawer), dropdown, modal (focus-trapped), tabs, toast, accordion, drawer, popover, segmented, combobox, multiselect, datepicker, and a generic data-vx-toggle; auto-init via data-vx-*.
  • Tailwind preset (optional) — require('@vinixinfotech/ui/preset').

Versioning

Semantic versioning (MAJOR.MINOR.PATCH). Consumers pin a version (^1.1) and are never affected by new releases until they run npm update / composer update. See the Changelog.

Develop

node scripts/build.mjs   # rebuild dist/ after editing src/  (zero-dependency)

dist/ is committed so git-tag installs work with no build step on the consumer side. Contributor notes and the release process live in CLAUDE.md.


© Vinix Infotech Pvt. Ltd. — released under the MIT License.

Comments