Skip to content

README.md

Latest commit

 

History

History
96 lines (68 loc) · 3.16 KB

README.md

File metadata and controls

96 lines (68 loc) · 3.16 KB
Raw

🚀 BlockDevelop IDE

Free, open-source Integrated Development Environment inspired by FlashDevelop & HaxeDevelop, built for visual block-based programming.

CI Status MIT License pnpm React 18 Electron 29

✨ Features & Architecture

BlockDevelop IDE bridges the productivity of professional text-based IDEs (FlashDevelop/HaxeDevelop) with visual block engines (Google Blockly):

  • 🧩 First-Class Visual Block Support: Drag-and-drop block coding powered by Google Blockly.
  • ⚡ Dual-Editor Real-Time Sync: Side-by-side Visual Blocks and generated target code.
  • 🖥️ Dockable Workspace UI: FlashDevelop-inspired dockable panels, split views, and customizable layouts.
  • 🎯 Multi-Target Code Generators: Export to JavaScript, TypeScript, Python, Haxe, Lua, and C++.
  • 🔒 Secure Desktop Runtime: Strict Context Isolation, Chromium OS Sandboxing, and typed IPC Context Bridge (window.blockDevelopAPI).
  • ⚡ Turbocharged Monorepo: Powered by pnpm workspaces, Turborepo, Vite, and TypeScript.

🏗️ Monorepo Package Structure

blockdevelop-ide/
├── apps/
│   └── desktop/        # Electron Main/Preload + React Renderer App
└── packages/
    ├── core/           # Shared types, IPC event maps, Zustand stores, Mitt event bus
    ├── block-engine/   # Custom Blockly canvas integration & block definitions
    ├── code-gen/       # Multi-language code generation pipelines
    └── ui/             # Shared Tailwind CSS components & React hooks

🚀 Getting Started

Prerequisites

Installation

# 1. Clone repository
git clone https://github.com/JimmiesAndTheCoders/blockdevelop-ide.git
cd blockdevelop-ide

# 2. Install monorepo dependencies
pnpm install

# 3. Build core packages
pnpm run build

# 4. Launch Desktop IDE in dev mode
pnpm --filter @blockdevelop/desktop dev

🧪 Testing & Quality Assurance

# Run unit tests across all packages
pnpm run test

# Typecheck TypeScript types
pnpm run typecheck

# Lint workspace files
pnpm run lint

📦 Packaging Desktop Binaries

# Package executable directory (.exe / .dmg / .AppImage)
pnpm --filter @blockdevelop/desktop package:dir

📄 License

This project is licensed under the MIT License.