@pycolors/ui 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PyColors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# @pycolors/ui
+
+Production-ready UI primitives for modern SaaS apps — built for
+**speed**, **consistency**, and **real-world patterns**.
+
+-   Accessible defaults (Radix + sane patterns)
+-   Works with Tailwind (tokens-driven styling)
+-   "Starter-grade" components: Tables, Dialogs, Sheets, Alerts,
+    Tabs...
+-   Designed to power the **PyColors SaaS Starter** and future Pro
+    templates
+
+------------------------------------------------------------------------
+
+## Install
+
+``` bash
+pnpm add @pycolors/ui
+# or
+npm i @pycolors/ui
+```
+
+## Peer dependencies
+
+This library expects React + lucide-react:
+
+``` bash
+pnpm add react react-dom lucide-react
+```
+
+## Quick usage
+
+``` tsx
+import { Button, Card, CardHeader, CardTitle, CardContent } from "@pycolors/ui";
+
+export function Example() {
+  return (
+    <Card bordered className="p-4">
+      <CardHeader className="p-0">
+        <CardTitle>Welcome</CardTitle>
+      </CardHeader>
+      <CardContent className="p-0 pt-4">
+        <Button>Get started</Button>
+      </CardContent>
+    </Card>
+  );
+}
+```
+
+## What's inside (v1)
+
+Exports currently include:
+
+-   Button
+-   Card
+-   Badge
+-   Input
+-   PasswordInput
+-   Alert
+-   Dialog
+-   Sheet
+-   DropdownMenu
+-   Tabs
+-   Toast
+-   Pagination
+-   Table
+-   Skeleton
+-   EmptyState
+-   cn / utils
+
+This is intentionally small and "starter-first": the goal is to ship a
+credible SaaS UX surface quickly, then expand.
+
+------------------------------------------------------------------------
+
+## Design approach
+
+PyColors UI is not "just components".\
+It's a product system:
+
+-   predictable layout primitives
+-   consistent tokens + spacing
+-   real data states (loading / empty / error)
+-   B2B SaaS patterns (members, billing, settings, projects)
+
+------------------------------------------------------------------------
+
+## Roadmap
+
+Next planned steps:
+
+-   `@pycolors/tokens` (CSS variables + semantic tokens)
+-   richer form primitives (Select, Checkbox, Radio, Switch)
+-   "Pro" layer: advanced components/patterns for paid templates
+
+------------------------------------------------------------------------
+
+## License
+
+MIT (unless you decide otherwise).
+
+------------------------------------------------------------------------
+
+## Links
+
+-   PyColors: https://pycolors.io
+-   Starters: https://pycolors.io/starters

package/package.json

@@ -1,6 +1,28 @@
 {
   "name": "@pycolors/ui",
-  "version": "1.0.0",
+  "version": "1.0.2",
+  "description": "Production-ready UI primitives for modern SaaS apps (Radix + Tailwind-friendly).",
+  "keywords": [
+    "pycolors",
+    "ui",
+    "components",
+    "radix",
+    "tailwind",
+    "saas",
+    "design-system",
+    "react"
+  ],
+  "license": "MIT",
+  "author": "PyColors",
+  "homepage": "https://pycolors.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pycolors-io",
+    "directory": "packages/ui"
+  },
+  "bugs": {
+    "url": "https://github.com/pycolors-io/pycolors-ui/issues"
+  },
   "private": false,
   "type": "module",
   "sideEffects": false,
@@ -12,7 +34,11 @@
       "default": "./dist/index.js"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "publishConfig": {
     "access": "public"
   },
@@ -27,7 +53,13 @@
   },
   "peerDependencies": {
     "react": ">=18",
-    "react-dom": ">=18"
+    "react-dom": ">=18",
+    "lucide-react": ">=0.300.0"
+  },
+  "peerDependenciesMeta": {
+    "lucide-react": {
+      "optional": true
+    }
   },
   "dependencies": {
     "@radix-ui/react-alert-dialog": "^1.1.15",