A modern, high-performance IDE built with C++ and React/TypeScript, featuring Chromium Embedded Framework (CEF) for seamless web-native integration. The project includes multiple executables: the main Hyperion IDE, terminal utilities (mikoterminal, termibench), and web helper components (mikowebhelper).
- 🚀 Native Performance: C++ backend with CEF-powered React frontend for optimal speed
- 🎨 Modern UI: Clean, responsive interface built with React, Redux Toolkit, and Tailwind CSS
- 🖥️ Custom Window Management: Borderless window with custom title bar and drag regions
- 📦 Binary Resource Embedding: Web assets compiled directly into the executable via miko:// protocol
- 🔍 Monaco Editor: Advanced code editing with syntax highlighting and IntelliSense
- 🎯 Multi-Target Building: Automated build system for main app and utility tools
- 🖼️ Off-Screen Rendering: CEF OSR for seamless integration with native window management
- 🔧 Terminal Integration: Built-in terminal utilities (mikoterminal, termibench)
- 🌐 Web Helper Components: Dedicated web helper processes for enhanced functionality
Hyperion/
├── app/ # C++ Native Application
│ ├── main.cpp # Application entry point with CEF initialization
│ ├── client/ # CEF browser client implementation
│ │ ├── platform/ # Platform-specific code
│ │ │ ├── windows/ # Windows-specific code
│ │ │ │ └── windowsplatform.cpp # Windows platform-specific code
│ │ │ ├── linux/ # Linux-specific code
│ │ │ │ └── linuxplatform.cpp # Linux platform-specific code
│ │ │ └── sysplatform.cpp # System platform-specific code
│ │ ├── client.cpp # Main client
│ │ ├── offscreenrender.cpp # CEF Offscreen Rendering
│ │ ├── renderermethod.cpp # Renderer methods
│ │ ├── windowed.cpp # SDL Window Management
│ │ ├── mikoclient.cpp # CEF Client (HyperionClient class)
│ │ └── app.cpp # CEF application class
│ ├── resources/ # Binary resource management
│ │ ├── resources.cpp # Resource provider for miko:// protocol
│ │ ├── webapp.cpp # Embedded web application resources
│ │ ├── editor.cpp # Embedded editor resources
│ │ └── menuoverlay.cpp # Embedded menu overlay resources
│ ├── renderer/ # Graphics rendering
│ │ ├── linux/ # Linux-specific renderer
│ │ │ └── vulkan_renderer.cpp # Vulkan renderer for Linux
│ │ ├── windows/ # Windows-specific renderer
│ │ │ └── dx11_renderer.cpp # DirectX 11 renderer for CEF integration
│ │ ├── renderer_factory.cpp # Renderer factory for platform selection
│ │ └── renderer_interface.cpp # Renderer interface for platform-specific implementations
│ ├── utils/ # Utilities and configuration
│ │ ├── logger.cpp # Logging system
│ │ └── config.hpp # Application configuration
│ ├── internal/ # Internal communication
│ │ └── simpleipc.cpp # Inter-process communication
│ ├── bootstrap/ # Application bootstrap
│ │ ├── platform/ # Platform-specific code
│ │ │ ├── windows/ # Windows-specific code
│ │ │ │ └── windows_dialog.cpp # Windows dialog implementation
│ │ │ │ └── windows_splash.cpp # Windows splash screen implementation
│ │ │ ├── linux/ # Linux-specific code
│ │ │ │ ├── linux_dialog.cpp # Linux dialog implementation
│ │ │ │ └── linux_splash.cpp # Linux splash screen implementation
│ │ ├── ui_factory.cpp # UI factory for platform selection
│ │ ├── ui_interface.cpp # UI interface for platform-specific implementations
│ │ └── bootstrap.cpp # Initialization and setup
│ ├── cli/ # Command-line utilities
│ │ ├── core/ # Core utilities and configuration
│ │ └── main.c # Command-line entry point
│ ├── terminal/ # Terminal UI
│ │ ├── processmanager.cpp # Process management for terminal utilities
│ │ ├── renderer.cpp # Terminal renderer
│ │ └── terminalbuffer.cpp # Terminal buffer management
├── mikobench/ # React/TypeScript Frontend
│ ├── src/ # WEBUI Source code directory
│ │ ├── rootui/ # Main application UI
│ │ │ ├── App.tsx # Root application component
│ │ │ ├── components/ # UI components (TitleBar, Navbar, Statusbar)
│ │ │ ├── contexts/ # React contexts (WorkbenchContext)
│ │ │ └── mikoide/ # Core IDE components (Workbench, TabBar)
│ │ ├── editor/ # Code editor implementation
│ │ │ ├── MonacoEditor.tsx # Monaco editor integration
│ │ │ ├── core/ # Editor core functionality
│ │ │ └── tabbar/ # Editor tab management
│ │ ├── components/ # Reusable UI components
│ │ │ ├── DOMEditor.tsx # DOM-based editor
│ │ │ ├── DOMTabBar.tsx # Tab bar component
│ │ │ └── LanguageSwitcher.tsx # Language selection
│ │ ├── overlays/ # UI overlays
│ │ │ ├── command/ # Command palette
│ │ │ └── menu/ # Context menus
│ │ ├── store/ # State management
│ │ │ ├── index.ts # Redux store configuration
│ │ │ └── editorSlice.ts # Editor state slice
│ │ ├── providers/ # React providers
│ │ │ └── QueryProvider.tsx # Query provider for data fetching
│ │ └── shared/ # Shared utilities
│ │ ├── context.ts # Shared context definitions
│ │ └── menu.ts # Menu utilities
│ └── buildweb.ts # Custom build script for web assets
└── tools/ # Build and Development Tools
├── build.ts # Multi-project CMake build automation
├── clean.ts # Project cleanup utility
├── cpplint.ts # C++ Linting Utility
├── prod.ts # Production build and packaging
└── utils/ # Build utilities
├── buildtobin.ts # HTML to C++ binary converter
└── iconconvert.ts # Icon format converter
-
Windows 10/11 with MSVC (Visual Studio 2019 or later)
(MSVC Build Tools are sufficient, full Visual Studio not strictly required) -
Linux with GCC/Clang
(all required dev packages such asbuild-essential,cmake,gtk3-dev,vulkan-sdk,libx11-devwill be auto-installed bybuild.ts) -
CMake 3.19+
(tested up to 3.30 — required for FetchContent and modern CMake features) -
Bun.js (latest)
(used for build tooling, TypeScript transpile, and resource bundling) -
Git with submodule support
(clone with--recurse-submodulesto avoid missing dependencies)
git clone --recursive https://github.com/mikofure/hyperion.git
cd mikoidebun install# Complete build process for application (auto platform detected)
bun run build:app# 1. Build React frontend
bun run build
# 2. Convert web assets to C++ binary resources
bun run buildtobin
# 3. Build main application (if linux is pre-install dependencies)
bun run build:cmake# Windows
.\build\Release\Hyperion.exe
# Linux
./build/Release/Hyperionbun run dev- Start development server for React frontendbun run build- Build production React frontendbun run preview- Preview built frontend
bun run build:cmake- Build specific CMake project (main, mikoterminal, termibench, mikowebhelper, hyprn)bun run clean:cmake- Clean specific CMake project
bun run buildtobin- Convert HTML/CSS/JS to C++ binary resourcesbun run iconconvert- Convert PNG icons to ICO format
bun run build:app- Complete development buildbun run tools/prod.ts --portable- Build portable executablemakensis shared\windows\installer.nsi- Build with installer for Windows
Built with modern React ecosystem:
- React 18.3 with TypeScript for component architecture
- Redux Toolkit for state management
- Tailwind CSS 4.1 for styling
- Monaco Editor for advanced code editing
- Vite 7.1 for fast development and building
- Custom build pipeline that generates single-file HTML for embedding
Native C++ application featuring:
- Chromium Embedded Framework (CEF) for rendering React frontend
- SDL3 for cross-platform window management and input handling
- DirectX 11 renderer for optimal graphics performance
- Vulkan renderer for cross-platform graphics support
- OpenGL renderer for fallback support
- Direct2D Native UI renderer for Windows
- GTK3/Cairo renderer for Linux
- Off-Screen Rendering (OSR) for seamless CEF integration
- Binary Resource Provider for embedded web assets via
miko://protocol - Custom window management with borderless design and drag regions
- Inter-process communication for component integration
- Terminal utilities including mikoterminal and termibench
- Web helper processes for enhanced functionality
Command-line utilities providing:
- mikoterminal - Terminal application with advanced features
- termibench - Terminal benchmarking and performance testing
- mikowebhelper - Web helper process for browser integration
- hyprn - CLI tool for system operations and utilities
The project uses a sophisticated build system:
- FetchContent for automatic dependency management
- Multi-platform support (Windows focus, Linux/macOS compatible)
- Automatic CEF download and extraction
- SDL3 integration with proper configuration
- Resource embedding system for web assets
Custom build automation providing:
- Multi-project builds with dependency management
- Parallel compilation for faster builds
- Verbose logging for debugging build issues
- Cross-platform compatibility checks
- Resource conversion pipeline
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Use Bun.js for all JavaScript/TypeScript operations
- Use CMake for all C++ builds (MSVC on Windows and GCC/Clang on Linux)
- Follow existing code style and conventions
- Add tests for new features
- Update documentation as needed
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with modern C++ and TypeScript
- Powered by CMake and Bun.js
- LSP integration for enhanced development experience
- Chromium Embedded Framework for seamless web-native integration
see in credit.md
MikoIDE - Modern IDE for Modern Development 🚀