Evidence-first DESIGN.md generator for public websites.

🇰🇷 한국어

Note

Author's Note

This project was originally intended to be sold as a paid product. However, as I decided to pursue a different business, I am releasing it as open-source! In return, I would highly appreciate it if you could show some interest in sensyk.com or give this repository a ⭐️ Star. Thank you!

---

📖 Table of Contents

• What is Rendered Design?
• Features
• Usage (For General Users)
• For Developers
• Configuration & Auth
• Output
• Security and Limitations
• Contributing
• License

---

💡 What is Rendered Design?

Rendered Design turns a public website URL into a Google DESIGN.md-compatible file using browser-observed design evidence. It's built with real design depth — including analyzed patterns, tokens, and rules — for high-quality UI generation, not surface-level outputs.

The Agent Design System Concept

Copy a DESIGN.md into your project, tell your AI agent "build me a page that looks like this," and generate high-quality UI that stays visually consistent with the design language.

File	Who reads it	What it defines
AGENTS.md	Coding agents	How to build the project
DESIGN.md	Design agents	How the project should look and feel

---

✨ Features

• 🖥️ Web UI Dashboard: Intuitive dashboard to extract design systems easily.
• 🎭 Playwright-Backed: Real DOM rendering and precise styling extraction.
• 🤖 LiteLLM Integration: Supports various models (OpenAI, Anthropic, Gemini, local models) with smart fallback. (Models with Vision capabilities yield significantly better performance!)
• ⚡ Automated Extraction: Generates design tokens, layout patterns, and typography rules in seconds.

---

🚀 Usage (For General Users)

Simply download and run the executable file for your operating system. No installation or terminal commands required!

• Windows: Download and run the .exe program.
• macOS: Download and run the .app program.

(Check the Releases page to download the latest version).

---

💻 For Developers

If you want to run from source code or modify the project:

Prerequisites

• Python 3.11, 3.12, or 3.13
• uv (Fast Python package installer)

Python 3.14 is not supported yet because the Windows desktop build depends on pywebview/pythonnet. Official release builds currently use Python 3.13.

Run

Scripts have been moved to the scripts/ folder for a cleaner root directory.

Linux, macOS, or WSL:

./scripts/run.sh

Windows PowerShell:

powershell -ExecutionPolicy Bypass -File .\scripts\run.ps1

Open http://127.0.0.1:8337 in your browser.

---

📦 Output

Generation writes one directory per job, with a single saved deliverable:

output/
  jobs/
    job_abc123/
      DESIGN.md

---

🛡️ Security and Limitations

• 🌐 Only public HTTP(S) URLs are supported.
• 🚫 Private IP ranges, localhost, and link-local addresses are blocked.
• 🔒 Login flows, file uploads, and form submissions are outside MVP scope.

---

🤝 Contributing

If you encounter any bugs, crashes, or issues, please feel free to open an Issue! We also highly welcome Pull Requests for bug fixes, code improvements, or new feature suggestions. Your contributions make this project better.

---

📄 License

This project is licensed under the Apache License 2.0. See the LICENSE file for more details.