sids 0.1.0

Selective Interface Design System: TailwindCSS + Python for universal GUIs

SIDS: Selective Interface Design System 🚀

SIDS (Selective Interface Design System) integrates TailwindCSS with Python for building beautiful GUIs everywhere - web apps, desktop applications, and Jupyter notebooks.

🎯 Features

• Declarative Python API - Build UIs like React, but in Python
• TailwindCSS Integration - Beautiful, responsive styling out of the box
• Multi-Platform Rendering - Deploy to Flask, FastAPI, Jupyter, or Tkinter
• Component Library - Pre-built buttons, cards, forms, and more
• CLI Tools - Easy project setup and development

🚀 Quick Start

Installation

pip install sids

Basic Example

import sids as ui

# Create an app
app = ui.App()

# Define your UI
with app.page("Dashboard"):
    ui.H1("Welcome to SIDS! 🎉", classes="text-blue-600")
    ui.Button(
        "Click Me", 
        color="blue",
        on_click=lambda: print("Hello from SIDS!")
    )
    ui.Card(
        "This is a beautiful card styled with Tailwind!",
        classes="bg-gradient-to-r from-purple-500 to-pink-500"
    )

# Run anywhere
app.run("flask")    # Web app
app.run("jupyter")  # Jupyter notebook
app.run("tkinter")  # Desktop app

📦 Installation Options

# Basic installation
pip install sids

# With FastAPI support
pip install sids[fastapi]

# With Jupyter support  
pip install sids[jupyter]

# With everything
pip install sids[all]

# For development
pip install sids[dev]

🛠️ CLI Usage

# Initialize a new SIDS project
sids init my-app

# Run development server
sids run

# Build for production
sids build

🏗️ Architecture

SIDS provides a unified API that renders to multiple backends:

┌─────────────────┐
│   Python API    │  ← Your Code Here
├─────────────────┤
│   SIDS Core     │  ← Component System
├─────────────────┤
│    Adapters     │  ← Backend Integration
├─────┬─────┬─────┤
│Flask│Jptr │Tkntr│  ← Render Targets
└─────┴─────┴─────┘

📚 Documentation

• Getting Started Guide
• Component Reference
• Adapter Guide
• API Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

• Built with TailwindCSS
• Inspired by Streamlit and React
• Python packaging with setuptools