Skip to content

HrsFlex/GenUI-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌌 ForceUI – The Self-Evolving Application Framework

An application that doesn't have a fixed interface. It learns, adapts, and rebuilds itself based on user intent, history, and context.

Built with Tambo MCP Enabled Hackathon 2026


πŸš€ Vision

ForceUI is a next-generation Generative UI framework that revolutionizes how users interact with applications. Instead of navigating through fixed menus and predetermined workflows, users simply describe what they need in natural language, and ForceUI automatically assembles the perfect interface.

πŸ“Έ Gallery

Main Dashboard

Dashboard View ForceUI's adaptive dashboard with timeline, stats, and component orchestration

Dark Mode

Dark Mode Dashboard Sleek dark mode experience with full theme support

Analytics Dashboard

Analytics Real-time analytics and metrics visualization

MCP Integration

MCP Status Model Context Protocol integrations with GitHub, Calendar, and more

Results View

Generated Results AI-generated UI components based on user intent

✨ Core Features

1. 🧠 Intent-Driven UI Orchestration

  • Natural Language Processing: Understands user intent from conversational input
  • Smart Component Selection: Automatically selects and renders the most relevant components
  • Context-Aware: Considers user history, persona, and preferences

2. πŸ‘€ Persona-Based Adaptation

  • Founder Mode: Focus on high-level metrics, timelines, and strategic planning
  • Developer Mode: Code-centric views, technical dashboards, and debugging tools
  • Analyst Mode: Data visualizations, reports, and deep analysis
  • Recruiter Mode: Candidate tracking, pipeline management

3. πŸ”Œ MCP Integrations (Model Context Protocol)

  • GitHub Integration: Real-time commit tracking, PR status, and issue management
  • Calendar Integration: Meeting schedules, event coordination
  • Analytics API: Live data streaming and metrics visualization
  • Workflow Recording: Capture and replay user workflows for automation

4. πŸͺ„ AI Explainability

  • Transparent Reasoning: See exactly why the AI chose specific components
  • Intent Analysis: Understand how your input was interpreted
  • Confidence Scores: View the AI's certainty in its decisions

5. πŸ“¦ Self-Composed Components

Every component is:

  • Schema-Validated with Zod for type safety
  • AI-Describable for intelligent selection
  • Persona-Aware for contextual display
  • Animated with Framer Motion for smooth transitions

πŸ— Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                        ForceUI                              β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚  Intent     β”‚  β”‚  Component  β”‚  β”‚   Explainability    β”‚  β”‚
β”‚  β”‚  Classifier β”‚β†’ β”‚  Orchestr.  β”‚β†’ β”‚      Engine         β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚   Memory    β”‚  β”‚   Persona   β”‚  β”‚   MCP Integrations  β”‚  β”‚
β”‚  β”‚    Store    β”‚  β”‚    Store    β”‚  β”‚  (GitHub, Calendar) β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚                   Tambo AI SDK + Next.js                    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ“ Project Structure

forceui/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/                    # Next.js pages
β”‚   β”‚   └── forceui/           # Main ForceUI application
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ generative/        # AI-rendered components
β”‚   β”‚   β”‚   β”œβ”€β”€ Timeline.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ StatsCard.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ ChartView.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ SummaryPanel.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ ExplainabilityPanel.tsx
β”‚   β”‚   β”‚   └── MCPStatusPanel.tsx  # MCP integrations demo
β”‚   β”‚   β”œβ”€β”€ interactable/      # User-interactive components
β”‚   β”‚   β”‚   β”œβ”€β”€ IntentChat.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ KanbanBoard.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ NotesPanel.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ PersonaSwitcher.tsx
β”‚   β”‚   β”‚   └── WorkflowRecorder.tsx  # Workflow recording demo
β”‚   β”‚   └── layout/            # Layout components
β”‚   β”œβ”€β”€ engine/                # Core intelligence layer
β”‚   β”‚   β”œβ”€β”€ intentClassifier.ts
β”‚   β”‚   β”œβ”€β”€ orchestrator.ts
β”‚   β”‚   β”œβ”€β”€ componentRegistry.ts
β”‚   β”‚   └── explainability.ts
β”‚   β”œβ”€β”€ stores/                # Zustand state management
β”‚   β”œβ”€β”€ config/                # Configuration files
β”‚   └── hooks/                 # Custom React hooks
└── screenshots/               # Demo screenshots

πŸ›  Tech Stack

Technology Purpose
Next.js 15 React framework with App Router
Tambo AI SDK Generative UI capabilities
TypeScript Type-safe development
Tailwind CSS Utility-first styling
Framer Motion Smooth animations
Recharts Data visualization
Zustand State management
Zod Schema validation
MCP Model Context Protocol integrations

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

# Navigate to the forceui directory
cd forceui

# Install dependencies
npm install

# Set up environment
cp example.env.local .env.local
# Add your Tambo API key to .env.local

# Run development server
npm run dev

Access the App

Open http://localhost:3000/forceui in your browser.


πŸ’‘ Example Use Cases

Try these prompts in the IntentChat:

Prompt Result
"Plan a product launch" Timeline + KanbanBoard + StatsCard
"Show my integrations" MCPStatusPanel with live status
"Record a workflow" WorkflowRecorder component
"Analyze user metrics" ChartView + StatsCard + SummaryPanel
"Switch to developer mode" UI adapts for developer persona

🎯 Hackathon Highlights

Innovation Points

  1. Intent-to-UI Pipeline: Revolutionary approach to UI generation
  2. MCP Integration: Showcasing Model Context Protocol for external tool access
  3. Explainable AI: Full transparency in AI decision-making
  4. Persona-Aware: Dynamic adaptation based on user role

Demo Flow

  1. Load the application β†’ See the animated welcome screen
  2. Try "Show my integrations" β†’ View the MCP Status Panel
  3. Click "Record a workflow" β†’ Interact with the Workflow Recorder
  4. Use "Plan a product launch" β†’ Watch components assemble
  5. Toggle "Show AI Reasoning" β†’ See the explainability panel

πŸ‘₯ Team

Built for the Tambo Hackathon 2026 πŸ†


πŸ“„ License

MIT License - See LICENSE for details.


πŸ”— Links