naksha-studio  by Adityaraj0421

AI-powered virtual design team for terminal-based development

Created 1 month ago
260 stars

Top 97.5% on SourcePulse

GitHubView on GitHub
Project Summary

A virtual design team integrated directly into the terminal, Naksha provides 26 specialist roles and over 60 commands to automate and enhance design workflows. It aims to act as an "agency's design brain," offering extensive expert knowledge to assist developers and designers in tasks ranging from UI creation and design system management to code generation and AI-assisted content production, streamlining the entire design-to-development lifecycle.

How It Works

Naksha operates via a "Design Manager" that orchestrates 26 specialist roles. When a command is invoked, the manager dynamically assembles the relevant specialists (e.g., UI Designer, Motion Designer, AI Prompt Engineer) based on the task. Each specialist contributes their expertise, enabling the system to execute complex design workflows, from initial strategy and creative execution to final build and delivery. Adaptive loading ensures that only necessary knowledge bases are accessed, optimizing performance for simpler tasks.

Quick Start & Requirements

  • Primary install / run command: Clone the repository (git clone https://github.com/Adityaraj0421/naksha-studio.git), navigate into the directory (cd naksha-studio), and execute the installation script (bash install.sh). Restart Claude Code to load the plugin.
  • Non-default prerequisites and dependencies: Requires the Claude Code CLI. Optional MCP servers are needed for full Figma and Preview capabilities. Integration with tools like Cursor, Windsurf, Gemini CLI, and Copilot involves manual file copying as per the README instructions.
  • Updates: Updates are handled via git pull within the local repository; no reinstallation is necessary.
  • Relevant pages: The README serves as the primary documentation and quick-start guide. A CHANGELOG.md is also provided.

Highlighted Details

  • Comprehensive Command Suite: Offers 60 commands covering a vast array of design tasks, including full design generation (/design), Figma manipulation (/figma-create, /site-to-figma), design system management (/design-system), code conversion across multiple frameworks (/design-framework), email template generation (/email-template), data visualization (/chart-design), and AI content generation (/gen-image, /gen-video).
  • Specialist Roles & Knowledge: Integrates 26 distinct specialist roles and over 13,800 lines of expert design knowledge, dynamically assembling teams for specific tasks.
  • Framework Agnostic Code Generation: Can convert designs into production-ready code for React (with Tailwind), Vue, Svelte, Next.js, and Astro.
  • Automated Quality Checks: Includes a GitHub Action for automatic design quality checks on pull requests, with local execution via scripts/design-lint.js.
  • Context-Aware Operation: Automatically detects the project's tech stack (CSS/JS frameworks, build tools, etc.) to tailor its recommendations and operations.

Maintenance & Community

The project is actively maintained, as indicated by its versioning (v4.8.0) and detailed command list. Community support links such as Discord or Slack are not explicitly provided in the README, but issues can be reported via GitHub issues.

Licensing & Compatibility

  • License type: MIT License.
  • Compatibility notes: Designed for integration with Claude Code, Cursor, Windsurf, Gemini CLI, and Copilot. The MIT license generally permits commercial use and integration into closed-source projects, subject to its terms.

Limitations & Caveats

The tool is primarily dependent on the Claude Code CLI for its core functionality. Full capabilities, particularly for Figma integration and live preview, require optional MCP servers. Integration with other IDEs involves manual setup steps outlined in the README.

Health Check
Last Commit

3 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
4
Issues (30d)
2
Star History
82 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.