chore: update pyproject.toml and README to include dependency groups

Author: phernandez

README.md

@@ -3,6 +3,35 @@
 Re-usable server-side components based on shadcn/ui.
 Built with JinjaX, Alpine.js, and Tailwind CSS, with support for htmx.
 
+## Installation & Usage
+
+### Quick Start with `uvx`
+
+You can use the CLI directly without installing the package:
+
+```bash
+# Add components
+uvx --from basic-components components add button
+```
+
+You will also need to configure your project to load components into the `jinjax.Catalog` and add a global `cn` function
+to the Jinja environment. See [utilities](docs/content/docs/utilities.md)
+
+### Package Installation Options
+
+Install only the utility functions for JinjaX and tailwind:
+
+```bash
+# With utility functions
+pip install basic-components[utils]
+```
+
+### Installation Groups
+
+- `utils`: Utility functions for JinjaX setup and `cn()` tailwind class helper
+- `docs`: Runs the docs site
+- `dev`: Development tools for contributing
+- `full`: All features included
 
 ## Documentation
 

pyproject.toml

@@ -7,8 +7,61 @@ authors = [
 ]
 readme = "README.md"
 requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = [
+    "web",
+    "components",
+    "jinja",
+    "jinjax",
+    "tailwind",
+    "htmx",
+    "alpinejs",
+    "fastapi",
+    "flask",
+    "django",
+    "ui",
+    "frontend",
+    "server-side",
+    "shadcn",
+    "shadcnui",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Framework :: FastAPI",
+    "Framework :: Flask",
+    "Framework :: Django",
+    "Framework :: Jinja",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: User Interfaces",
+    "Typing :: Typed",
+]
 
+# Core dependencies needed for CLI
 dependencies = [
+    "copier>=9.4.1",
+    "typer>=0.9.0",
+    "rich>=13.7.0",
+]
+
+[project.optional-dependencies]
+
+# For using the utility functions in basic_components/utils
+utils = [
+    "jinjax>=0.47",
+    "jinja2>=3.1.3",
+    "tomli>=2.0.2",
+]
+
+docs = [
     "fastapi[standard]>=0.115.4",
     "jinjax[whitenoise]>=0.47",
     "pyright>=1.1.385",
@@ -35,12 +88,30 @@ dependencies = [
     "tomli>=2.0.2",
 ]
 
+# Development dependencies
+dev = [
+    "black>=24.1.0",
+    "isort>=5.13.0",
+    "mypy>=1.8.0",
+    "ruff>=0.2.0",
+]
+
+# Full install with all features
+full = [
+    "basic-components[utils]",
+    "basic-components[docs]",
+    "basic-components[dev]",
+]
+
 [project.scripts]
 components = "basic_components.cli:app"
 
 [project.urls]
 Homepage = "https://github.com/basicmachines-co/basic-components"
 Documentation = "https://components.basicmachines.co"
+Repository = "https://github.com/basicmachines-co/basic-components"
+Changelog = "https://github.com/basicmachines-co/basic-components/blob/main/CHANGELOG.md"
+Issues = "https://github.com/basicmachines-co/basic-components/issues"
 
 [build-system]
 requires = ["hatchling"]
@@ -55,8 +126,6 @@ components = "basic_components.cli:app"
 [tool.hatch.build]
 include = [
     "basic_components/**/*.py",
-    "components/**/*",
-    "docs/**/*",
 ]
 
 [tool.basic-components]