Mango

A fast, native MongoDB GUI — built with Perry

MongoDB, finally fast.

---

Mango is a native desktop MongoDB client written in TypeScript and compiled to native ARM64/x86_64 using Perry. No Electron, no JVM, no runtime overhead — just a small, fast binary that talks directly to your database.

Features

• Connection management — Save, edit, and delete connection profiles. Connect via host/port or full connection string (SCRAM-SHA-256, TLS).
• Database & collection browser — Query any collection with custom filters, sort, and projection.
• Document viewer — Browse query results as formatted JSON.
• Document editing — Edit documents inline and save changes back to MongoDB.
• Document CRUD — Insert, update, delete, and duplicate documents.
• Index listing — View indexes with key, uniqueness, and size info.
• Dark & light mode — Follows system preference automatically.
• Cross-platform — Targets macOS (AppKit), iOS (UIKit), Android (Views), Linux (GTK4), and Windows (Win32).

Getting Started

Prerequisites

• Perry compiler
• Bun (for type-checking and running tests)
• A running MongoDB instance

Build

# Install type-checking dependencies
bun install

# Compile to native binary
perry compile src/app.ts --output mango

# Run
./mango

Development

# Type-check
perry check

# Run tests
bun test

Project Structure

src/
  app.ts                 # Entry point — screens, navigation, UI
  data/
    connection-store.ts  # SQLite CRUD for saved connections
    mongo-client.ts      # MongoDB client wrapper
    preferences.ts       # User preferences (theme, page size, etc.)
    database.ts          # SQLite database helper
  theme/
    colors.ts            # Mango color palette (light/dark)
    typography.ts        # Platform-specific font families
tests/                   # Unit and integration tests
logo/                    # App icons and brand assets
perry.config.ts          # Perry build configuration
perry.toml               # Perry project manifest

How It Works

Perry compiles TypeScript to native machine code via SWC (parsing) and Cranelift (codegen). Platform UI is rendered through native frameworks — AppKit on macOS, UIKit on iOS, GTK4 on Linux, etc. MongoDB access uses Perry's built-in mongodb package, which wraps the Rust MongoDB driver directly in the compiled binary.

The result is a ~7 MB self-contained binary with sub-100 MB RAM usage and instant cold start.

License

MIT — Skelpo GmbH