10000 GitHub - seanulacra/hedgekit
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

seanulacra/hedgekit

Repository files navigation

HedgeKit πŸ¦”

License: MIT TypeScript React Vite HedgeKit

Collaborative Agents for More Precise UI Generation

HedgeKit is a schema-driven frontend code generation platform that leverages multiple AI models to help developers build React components and web applications faster. It features live preview, intelligent project planning, and collaborative AI agents that work together to create cohesive user interfaces.

🌟 Features

πŸ€– Multi-Agent Collaboration

  • Multiple AI Providers: Supports OpenAI GPT, Claude Sonnet 4, Claude Opus 4, and Vercel v0
  • Agent Orchestration: Intelligent workflow automation with automatic tool chaining
  • Action Budget System: Smart resource management to optimize AI usage

πŸ”¨ Component Generation

  • AI-Powered Component Builder: Generate React components from natural language descriptions
  • Multiple Generation Methods: Choose between OpenAI GPT or Vercel v0 for component creation
  • Live Code Preview: See your components rendered in real-time as they're generated

🎨 Asset Management

  • AI Image Generation: Create images and logos using AI
  • CDN Integration: Automatic upload to BunnyCDN for fast global delivery
  • Asset Organization: Built-in image manager with editing capabilities

πŸ“‹ Project Planning

  • AI Project Planner: Break down projects into phases, milestones, and actionable tasks
  • Task Tracking: Monitor progress with status updates and completion tracking
  • Execution CTAs: One-click actions to execute tasks or start development sessions

πŸ‘οΈ Live Preview System

  • Unified Preview: See all components and scenes in one place
  • Multiple Preview Modes: Fast preview, compiled preview, and static preview options
  • Screenshot Capture: Capture and analyze component screenshots for quality assessment

πŸ—οΈ Project Management

  • Multi-Project Support: Manage multiple projects with different configurations
  • Schema-Driven Architecture: Define project structure with TypeScript schemas
  • Version Control Ready: Clean project structure optimized for Git workflows

🎨 Demo & Prototype

Check out the HedgeKit UI Prototype on v0.dev to see the design and user experience concepts behind the platform. And the initial planning and generation exchange on YouTube

πŸš€ Getting Started

Prerequisites

  • Node.js 18+ (.nvmrc file included)
  • npm or yarn
  • API keys for AI providers (at least one):
    • OpenAI API key (VITE_OPEN_AI_KEY)
    • Anthropic API key (VITE_ANTHROPIC_KEY)
    • Vercel token (VITE_VERCEL_TOKEN) for v0 generation

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/hedgekit.git
cd hedgekit
  1. Install dependencies:
npm install
  1. Set up environment variables:
cp .env.example .env

Edit .env and add your API keys:

VITE_OPEN_AI_KEY=your_openai_key
VITE_ANTHROPIC_KEY=your_anthropic_key
VITE_VERCEL_TOKEN=your_vercel_token
VITE_BUNNY_CDN_API_KEY=your_bunny_cdn_key (optional)
  1. Start the development server:
npm run dev

πŸ“– Usage

Creating a New Project

  1. Launch HedgeKit and click "Create New Project"
  2. Enter project details:
    • Name and description
    • Framework (React)
    • Choose a theme preset or customize colors
  3. Click "Create Project"

Generating Components

  1. Navigate to the Build Tools tab
  2. In the Component Generator:
    • Select generation method (OpenAI or v0)
    • Describe your component in natural language
    • Click "Generate"
  3. The component will appear in the Project tab with live preview

Using AI Agents

  1. Click the chat icon to open the Agent Sidebar
  2. Type your request, for example:
    • "Create a user profile card with avatar and social stats"
    • "Generate a project plan for a recipe sharing app"
    • "Build a navigation menu with dropdown support"
  3. The agent will execute tools and create artifacts automatically

Working with Project Plans

  1. Go to the Plan tab
  2. Click "Generate Project Plan" or ask the agent
  3. Review the generated phases, milestones, and tasks
  4. Use action buttons to:
    • Start a development session
    • Execute specific tasks
    • Review and update the plan

πŸ—οΈ Architecture

HedgeKit is built with modern web technologies:

  • Frontend Framework: React 19 with TypeScript
  • Build Tool: Vite 6 for fast development
  • Styling: Tailwind CSS with shadcn/ui components
  • State Management: React hooks and contexts
  • Code Editor: CodeMirror 6
  • AI Integration: Multiple provider abstraction layer

Key Components

  • AgentOrchestrator: Manages AI providers and tool execution
  • ComponentGenerator: Handles component creation logic
  • ProjectManager: Multi-project state management
  • UnifiedPreview: Live component rendering system
  • AgentTools: Extensible tool system for AI actions

πŸ› οΈ Development

Running Tests

npm run test

Type Checking

npm run typecheck

Linting

npm run lint

Building for Production

npm run build

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

πŸ“ž Support

  • Create an Issue for bug reports
  • Join our Discord for community support
  • Check the Wiki for documentation

Made with ❀️ by the HedgeKit Team during: image

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

0