peasy-css

Async Rust client for the PeasyCSS API -- minify, beautify, and convert CSS units with tools for gradient generation, shadow creation, flexbox layouts, and grid systems. Built with reqwest, serde, and tokio.

Built from PeasyCSS, a comprehensive CSS toolkit offering free online tools for minifying, formatting, analyzing, and generating CSS code with detailed property guides, layout references, and a glossary covering modern CSS specifications including Grid, Flexbox, Custom Properties, and Container Queries.

Try the interactive tools at peasycss.com -- CSS Minify, CSS Beautify, CSS Unit Converter, and more.

Table of Contents

• Install
• Quick Start
• What You Can Do
  • CSS Optimization Tools
  • Browse CSS Reference Content
  • Search and Discovery
• API Client
  • Available Methods
• Learn More About CSS Tools
• Also Available
• Peasy Developer Tools
• License

Install

[dependencies]
peasy-css = "0.2.0"
tokio = { version = "1", features = ["full"] }

Or via cargo:

cargo add peasy-css

Quick Start

use peasy_css::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    // List available CSS tools
    let tools = client.list_tools(&Default::default()).await?;
    for tool in &tools.results {
        println!("{}: {}", tool.name, tool.description);
    }

    Ok(())
}

What You Can Do

CSS Optimization Tools

CSS optimization is essential for web performance. Minified CSS reduces file sizes by removing whitespace, comments, and redundant declarations, while beautified CSS restores readability for debugging. The PeasyCSS API provides programmatic access to these transformations alongside unit conversion tools for responsive design workflows.

use peasy_css::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    // Fetch the CSS Minify tool details
    let tool = client.get_tool("css-minify").await?;
    println!("Tool: {}", tool.name);           // CSS minification tool
    println!("Category: {}", tool.category);   // CSS optimization category

    // List all CSS file formats and their MIME types
    let formats = client.list_formats(&Default::default()).await?;
    for fmt in &formats.results {
        println!(".{} -- {} ({})", fmt.extension, fmt.name, fmt.mime_type);
    }

    Ok(())
}

Learn more: CSS Minify Tool · CSS Beautify Tool · How to Minify CSS for Production

Browse CSS Reference Content

Modern CSS has evolved far beyond simple selectors and properties. Concepts like CSS Grid, Flexbox, Custom Properties (CSS variables), specificity rules, and the cascade determine how styles are applied. The PeasyCSS glossary provides clear definitions and practical examples for these foundational concepts, while guides offer in-depth tutorials on layout techniques and optimization strategies.

// Browse CSS glossary terms programmatically
let glossary = client.list_glossary(&peasy_css::ListOptions {
    search: Some("flexbox".into()),
    ..Default::default()
}).await?;
for term in &glossary.results {
    println!("{}: {}", term.term, term.definition); // Flexbox layout definition
}

// Read in-depth CSS guides on layout and optimization
let guides = client.list_guides(&peasy_css::ListGuidesOptions {
    category: Some("layout".into()),
    ..Default::default()
}).await?;
for guide in &guides.results {
    println!("{} ({})", guide.title, guide.audience_level); // Guide title and difficulty
}

Learn more: Flexbox Glossary · Grid Glossary · CSS Grid vs Flexbox Guide

Search and Discovery

The unified search endpoint queries across all CSS tools, glossary terms, guides, and file formats simultaneously. This is useful for building IDE integrations, documentation search, or CLI tools that need to surface relevant CSS content based on user queries.

// Search across all CSS tools, glossary, and guides
let results = client.search("gradient generator", Some(20)).await?;
println!("Found {} tools, {} glossary terms",
    results.results.tools.len(),
    results.results.glossary.len()); // Cross-content CSS search results

Learn more: Specificity Glossary · Custom Property Glossary · All CSS Guides

API Client

The client wraps the PeasyCSS REST API with strongly-typed Rust structs using serde deserialization.

use peasy_css::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    // Or with a custom base URL:
    // let client = Client::with_base_url("https://custom.example.com");

    // List tools with filters
    let opts = peasy_css::ListOptions {
        page: Some(1),
        limit: Some(10),
        search: Some("minify".into()),
        ..Default::default()
    };
    let tools = client.list_tools(&opts).await?;

    // Get a specific tool
    let tool = client.get_tool("css-minify").await?;
    println!("{}: {}", tool.name, tool.description);

    // Search across all content
    let results = client.search("minify", Some(20)).await?;
    println!("Found {} tools", results.results.tools.len());

    // Browse the glossary
    let glossary = client.list_glossary(&peasy_css::ListOptions {
        search: Some("flexbox".into()),
        ..Default::default()
    }).await?;
    for term in &glossary.results {
        println!("{}: {}", term.term, term.definition);
    }

    // Discover guides
    let guides = client.list_guides(&peasy_css::ListGuidesOptions {
        category: Some("css".into()),
        ..Default::default()
    }).await?;
    for guide in &guides.results {
        println!("{} ({})", guide.title, guide.audience_level);
    }

    // List format conversions
    let conversions = client.list_conversions(&peasy_css::ListConversionsOptions {
        source: Some("css".into()),
        ..Default::default()
    }).await?;

    Ok(())
}

Available Methods

Full API documentation at peasycss.com/developers/. OpenAPI 3.1.0 spec: peasycss.com/api/openapi.json.

Learn More About CSS Tools

• Tools: CSS Minify · CSS Beautify · CSS Unit Converter · All Tools
• Guides: CSS Grid vs Flexbox · How to Minify CSS for Production · All Guides
• Glossary: Flexbox · Grid · Minification · Specificity · Custom Property · All Terms
• Formats: All Formats
• API: REST API Docs · OpenAPI Spec

Also Available

Peasy Developer Tools

Part of the Peasy Tools open-source developer ecosystem.

License

MIT