styleseed  by bitjaru

AI UI design judgment engine

Created 3 weeks ago

New!

327 stars

Top 83.5% on SourcePulse

GitHubView on GitHub
Project Summary

This project addresses the common issue of AI-generated user interfaces appearing amateurish or generic. It provides a comprehensive design system, termed "StyleSeed," which injects design judgment into AI coding workflows, enabling developers to produce professional-looking UIs without extensive design expertise. The target audience includes developers leveraging AI coding assistants like Claude Code and Cursor, aiming to accelerate development while maintaining high UI quality.

How It Works

StyleSeed operates on a two-part system: a brand-agnostic "Engine" and customizable "Skins." The Engine comprises 69 codified design rules, 48 React components (built upon shadcn/ui patterns), and 11 AI-powered skills. This engine imparts "design judgment"—the nuanced understanding of visual hierarchy, rhythm, and refinement—rather than just raw design data. Users then apply a Skin, typically a theme.css file, which defines the visual identity (colors, typography, shadows) based on established brands like Toss, Stripe, Vercel, or Notion, or custom palettes. This approach allows the same design intelligence to be applied across diverse brand aesthetics.

Quick Start & Requirements

  • Primary install/run: Copy the engine directory into your project (cp -r engine/* your-project/) and run the interactive setup wizard (/ss-setup). For Cursor integration, copy .cursorrules (cp engine/.cursorrules your-project/.cursorrules).
  • Prerequisites: React 18, TypeScript, Tailwind CSS v4, Radix UI, Vite 6. Integration is specifically designed for Claude Code and Cursor.
  • Links: AI Chat Demo: https://styleseed-demo.vercel.app, Pricing Demo: https://styleseed-demo.vercel.app/pricing, Wiki: ../../wiki.

Highlighted Details

  • Features 69 codified design rules and 48 React components, including primitives and common patterns.
  • Integrates 11 AI-powered skills for automated setup, UI generation, code review, accessibility audits, and UX evaluation.
  • Supports multiple pre-built brand "skins" (Toss, Stripe, Linear, Vercel, Notion) and allows easy integration of over 58 additional brands from awesome-design-md.
  • Differentiates itself by focusing on teaching AI "design judgment" (how designers think) rather than solely providing more design data.

Maintenance & Community

The provided README does not detail specific maintainers, sponsorships, or community channels (e.g., Discord, Slack). It directs users to a Wiki for documentation and includes contribution guidelines.

Licensing & Compatibility

The project is released under the MIT License, permitting free use, modification, and distribution, including for commercial purposes.

Limitations & Caveats

The system is tightly coupled with React 18 and requires Tailwind CSS v4, which may represent a significant dependency for existing projects. Its AI integration is primarily tailored for Claude Code and Cursor, with less explicit support for other AI coding assistants. The effectiveness of the "design judgment" relies heavily on the completeness and accuracy of the 69 codified rules.

Health Check
Last Commit

6 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
1
Star History
327 stars in the last 21 days

Explore Similar Projects

Feedback? Help us improve.