flow-ui

Styled Svelte 5 UI components with Tailwind CSS v4.

This repo is the library only (src/lib → dist/). Demos and docs sites live elsewhere.

Stack

Tool	Version
Svelte	^5.56
SvelteKit (packaging host)	^2.63
Tailwind CSS	^4.3
Package	@sveltejs/package

Develop

pnpm install
pnpm run package   # build library → dist/
pnpm run check

• Public API: docs/components.md
• Theming: docs/theming.md

Install from GitHub (pnpm)

pnpm add github:namtph/flow-ui
# or pin a branch / tag / commit:
pnpm add github:namtph/flow-ui#main

In the consumer app CSS (Tailwind v4):

@import 'tailwindcss';
@import 'flow-ui/theme.css';
@source "../node_modules/flow-ui/dist";

The library requires flow-ui/theme.css. Override tokens in a later @theme block — see docs/theming.md.

Then import components from flow-ui (see docs/components.md).

prepare runs svelte-package after install so dist/ is available from the GitHub clone.

Makefile

Command	Purpose
make build	Rebuild publishable dist/
make publish	Rebuild lib and git push current branch
make release TAG=vX.Y.Z	Create git tag + GitHub release

Scripts

Command	Purpose
pnpm run package / build	Build publishable dist/
pnpm run check	Typecheck
pnpm run lint / format	ESLint + Prettier