An open-source UI component ecosystem combining the structural simplicity of Bootstrap 5 with the utility power of Tailwind CSS v4. Built on a copy-and-paste architecture for total code ownership.
Polinema UI is designed for building accessible, high-performance web applications—ranging from academic portals and admin dashboards to enterprise platforms. Inspired by the shadcn/ui distribution model, components are not installed as a monolithic NPM dependency. Instead, you copy the component source code directly into your codebase, granting you 100% control over design, markup, and functionality.
Our core principle is straightforward: the code belongs to you, not us.
Monolithic package dependencies create rigid black boxes that break when custom requirements emerge. For academic institutions and enterprise systems with distinct branding or complex workflows, adaptability is mandatory. Polinema UI provides a transparent, unopinionated foundation that is easy to read, modify, and extend without theme lock-ins.
| Feature | Description |
|---|---|
| Hybrid Architecture | Merges the predictable grid layout of Bootstrap 5 with the flexibility of Tailwind CSS v4 utilities. |
| Copy & Paste Model | Zero rigid package setup. Paste source code directly into your project and maintain full ownership. |
| Enterprise & Academic Focus | Structured out of the box for data tables, multi-step forms, analytics dashboards, and portal systems. |
| Fully Customizable | Unlocked styling with no restrictive design themes—modify utility classes and markup directly. |
| Type-Safe & i18n Ready | Built with first-class TypeScript support and Paraglide-js internationalization. |
- Styling Engine: Tailwind CSS v4 & shadcn-svelte conventions
- Icons: Hugeicons Svelte
- Internationalization: Paraglide-js
- Validation & Testing: Vitest (Unit) & Playwright (E2E)
- Code Quality: ESLint, Prettier, and Knip
- Node.js (v18+) or Bun runtime
- Package manager (
bun,pnpm, ornpm)
# Clone the repository
git clone https://github.com/polinema-ui/website.git
cd website
# Install dependencies
bun install
# Start local development server
bun run devOpen http://localhost:4000 in your browser to view the documentation portal.
Execute these validation commands before committing changes:
| Command | Action |
|---|---|
bun run check |
Compiles Paraglide translations, syncs SvelteKit, and verifies TypeScript types. |
bun run lint |
Audits code formatting (Prettier) and code style rules (ESLint). |
bun run format |
Automatically formats the entire codebase. |
bun run test:unit |
Executes unit tests via Vitest. |
bun run knip |
Audits unused files, exports, and dependencies. |
├── messages/ # i18n translation files
├── project.inlang/ # Paraglide internationalization settings
├── src/
│ ├── lib/
│ │ ├── components/ # Atomic & compound UI components
│ │ ├── constants/ # Route definitions & system configurations
│ │ ├── paraglide/ # Compiled multi-language runtime
│ │ └── utils/ # Helper utilities & class merging logic
│ └── routes/ # Application routes and documentation pages
Contributions are welcome! Please review our CONTRIBUTING.md guide before submitting pull requests.
Distributed under the MIT License. See LICENSE for details.