Skip to content

TheAgencyMGE/Enigma

Repository files navigation

🎨 Enigma AI - AI-Powered Development Platform

Enigma AI Logo

Transform your ideas into stunning websites and mobile apps with the power of AI

Built with TypeScript React Vite License

✨ Overview

Enigma AI is a revolutionary AI-powered development platform that enables anyone to create beautiful, production-ready websites and mobile applications using natural language. Simply describe what you want to build, and watch as our advanced AI generates complete, functional code with modern design patterns and animations.

πŸš€ Key Features

🎯 Dual-Mode Development

  • Web Mode: Generate responsive HTML, CSS, and JavaScript websites
  • Mobile Mode: Create React Native mobile applications for iOS & Android

πŸ€– Advanced AI Engine

  • Gemini 2.5 Pro: Primary AI model for code generation
  • DeepSeek Reasoner: Intelligent fallback system
  • Template System: Reliable backup generation

⚑ Real-Time Development

  • Live preview as you build
  • Interactive chat interface
  • Instant code generation and updates
  • Export ready-to-deploy projects

🎨 Modern Tech Stack

  • React 18 with TypeScript
  • Tailwind CSS for styling
  • Vite for lightning-fast development
  • shadcn/ui component library

πŸ› οΈ Technology Stack

Frontend Backend AI/ML Build Tools
React Node.js Google Gemini Vite
TypeScript Express DeepSeek ESLint
Tailwind CSS PostCSS

🎯 Project Structure

enigma-ai/
β”œβ”€β”€ πŸ“ public/                 # Static assets
β”œβ”€β”€ πŸ“ src/
β”‚   β”œβ”€β”€ πŸ“ components/         # React components
β”‚   β”‚   β”œβ”€β”€ ChatInterface.tsx  # AI chat system
β”‚   β”‚   β”œβ”€β”€ Preview.tsx        # Live preview pane
β”‚   β”‚   β”œβ”€β”€ ProjectDashboard.tsx # Main dashboard
β”‚   β”‚   └── ui/               # shadcn/ui components
β”‚   β”œβ”€β”€ πŸ“ services/          # API services
β”‚   β”‚   └── aiService.ts      # AI integration layer
β”‚   β”œβ”€β”€ πŸ“ hooks/             # Custom React hooks
β”‚   β”œβ”€β”€ πŸ“ lib/               # Utility functions
β”‚   └── πŸ“ pages/             # Page components
β”œβ”€β”€ πŸ“„ .env                   # Environment variables
β”œβ”€β”€ πŸ“„ package.json           # Dependencies
└── πŸ“„ vite.config.ts         # Vite configuration

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/TheAgencyMGE/Enigma.git
    cd Enigma
  2. Install dependencies

    npm install
  3. Set up environment variables

    cp .env.example .env

    Add your API keys:

    VITE_GEMINI_API_KEY=your_gemini_api_key_here
    VITE_DEEPSEEK_API_KEY=your_deepseek_api_key_here
  4. Start the development server

    npm run dev
  5. Open your browser Navigate to http://localhost:8080

πŸ’‘ How to Use

1. Create a New Project

  • Choose between Website or Mobile App
  • Click "New Project" from the dashboard

2. Describe Your Vision

  • Use natural language to describe your application
  • Example: "Create a modern portfolio website with a hero section, about me, and contact form"

3. Watch AI Generate Code

  • Enigma AI will generate complete, production-ready code
  • Preview updates in real-time

4. Iterate and Refine

  • Continue the conversation to add features
  • Modify existing components
  • Export when ready

🎨 Example Prompts

Web Development

  • "Create a landing page for a tech startup with modern animations"
  • "Build an e-commerce product showcase with filtering"
  • "Design a blog layout with dark mode toggle"

Mobile Development

  • "Create a social media app login screen"
  • "Build a todo app with swipe gestures"
  • "Design a restaurant menu app with navigation"

πŸ“š API Documentation

AI Service Integration

import { generateWithAI } from '@/services/aiService';

const response = await generateWithAI(
  prompt,              // Your natural language prompt
  projectType,         // 'website' | 'mobile' | 'fullstack'
  existingCode,        // Current project code
  conversationHistory, // Chat history
  existingFiles,       // Project files
  developmentMode      // 'web' | 'mobile'
);

πŸ›‘οΈ Environment Variables

Variable Description Required
VITE_GEMINI_API_KEY Google Gemini API key βœ…
VITE_DEEPSEEK_API_KEY DeepSeek API key βœ…

🀝 Contributing

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

Development Workflow

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

πŸ“„ License

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

🎯 Roadmap

  • Advanced AI Models: Integration with GPT-4, Claude
  • Team Collaboration: Multi-user project editing
  • Version Control: Built-in Git integration
  • Deployment: One-click deployment to various platforms
  • Templates: Pre-built project templates
  • Plugin System: Extensible architecture

πŸ‘₯ Team

Built with ❀️ by The Agency MGE

Website β€’ Twitter β€’ LinkedIn

🌟 Show Your Support

If you found this project helpful, please give it a ⭐ on GitHub!


Enigma AI - Where Ideas Become Reality ✨

Transform your imagination into production-ready applications with the power of AI

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages