tailpyscss 0.1.0

A Python-native utility-first CSS generator and compiler.

TailPySCSS

The Python-Native Utility CSS Engine

TailPySCSS is a lightweight, zero-node utility CSS system. It gives you the power of utility classes (like Tailwind) without needing npm, node_modules, or complex Javascript build steps.

100% Python. 100% Open Source.

Created by Abdi Abdikarim

---

🚀 Features

• Zero Node.js: No npm or package.json clutter.
• Python Native: Install via pip. Works with Flask, Django, FastAPI, or static sites.
• Utility Generator: Instantly generates Grid, Flexbox, Typography, Colors, and Spacing.
• Built-in Compiler: Compiles SCSS to CSS using libsass automatically.
• Arbitrary Values (JIT): Use w-[500px], min-h-[80rem] directly in SCSS.
• Smart Watch Mode: Auto-rebuilds when you save your files.
• Extensible: Use standard SCSS or our tailpy.config.json.

---

📦 Installation

pip install tailpyscss

---

⚡ Quick Start

1. Initialize

Go to your project folder (e.g., my-website) and run:

python -m tailpyscss.cli init

This creates:

• tailpy.config.json (Your settings)
• styles/ folder (Your SCSS)

2. Build or Watch

To build once:

python -m tailpyscss.cli build

To watch for changes while you develop:

python -m tailpyscss.cli watch

3. Use in HTML

Link the generated file in your HTML:

<link rel="stylesheet" href="static/css/output.css">

Now you can use classes like:

<div class="flex flex-col bg-primary p-4 rounded-lg">
    <h1 class="text-3xl font-bold text-white">Hello World</h1>
</div>

---

📚 Documentation

• Class Reference: Valid list of all generated classes.
• Contributing Guide: How to develop the framework itself.
• Security Policy: Reporting vulnerabilities.

---

⚙️ Configuration

Customize your theme in tailpy.config.json:

{
    "theme": {
        "colors": {
            "primary": "#3b82f6",
            "brand": "#ff5722"
        }
    }
}

---

📄 License

MIT License. Free for commercial and private use.