tryandromeda / andromeda

Andromeda **A modern, fast(eventually), and secure JavaScript & TypeScript runtime** built from the ground up in Rust 🦀 and powered by Nova Engine and Oxc. Andromeda provides **zero-config TypeScript support**, **rich Web APIs**, and **native performance** - making it perfect for scripts, utilities, and applications that need to run fast without the complexity of traditional Node.js setups. Join our Discord community to discuss ideas and get involved! Key Features • **Zero-configuration TypeScript** - Run files directly, no transpilation needed • **Import Maps** - Modern module resolution with bare specifiers and CDN integration **Built-in HTTP Server** - Create web servers and APIs with minimal configuration • **GPU-Accelerated Canvas** - Hardware-accelerated 2D Canvas API with WGPU backend and PNG export • **Web Crypto API** - Industry-standard cryptographic primitives • **SQLite Support** - Built-in support for SQLite databases • **File System Access** - Simple APIs for reading/writing files • **Web Storage** - localStorage and sessionStorage APIs for data persistence • **Native Performance** - Rust-powered execution with Nova's optimized JS engine • **Developer Tools** - Interactive REPL, code formatter, single-file compilation, and performance profiling with hotpath • **Performance Profiling** - Integrated hotpath profiler for identifying bottlenecks and optimizing runtime performance for andromeda development • **Web Standards** - TextEncoder/Decoder, Performance API, and more • **Extensible** - Modular architecture with optional features • **Self-Updating** - Built-in upgrade system to stay current with latest releases • **Shell Integration** - Auto-completion support for bash, zsh, fish, and PowerShell Standards & Compatibility Andromeda aims to be **WinterTC** compliant, ensuring interoperability and compatibility with the broader JavaScript ecosystem. WinterTC provides a test suite for JavaScript engines to ensure they conform to ECMAScript standards and common runtime behaviors. > **Note:** ⚠️ Andromeda is in active development. While functional, it's not > yet recommended for production use. Quick Start Installation Platform specific instructions: Linux/Mac: Windows (PowerShell): Windows (CMD): Install Andromeda using Cargo: Install Andromeda using winget: Running Code Execute JavaScript or TypeScript files directly: Example: Hello World with Canvas Example: Standard Library Core APIs File System Canvas & Graphics Web Storage Cryptography Performance Monitoring Database Operations Developer Experience Interactive REPL Andromeda includes a powerful REPL with enhanced developer experience: **REPL Features:** • **Advanced Syntax Highlighting** - TypeScript-aware coloring with keyword recognition • **Smart Multiline Input** - Automatic detection of incomplete syntax (functions, objects, etc.) • **Performance Metrics** - Execution timing for every evaluation • **Command History** - Navigate through previous commands with arrow keys • **Built-in Commands** - , , , , • **Auto-completion** - Context-aware suggestions for JavaScript/TypeScript Code Formatting Format TypeScript and JavaScript files with the built-in formatter: Single-File Compilation Compile your scripts into standalone executables: Language Server Protocol (LSP) Andromeda includes a built-in Language Server that provides real-time diagnostics and linting capabilities for JavaScript and TypeScript files in your editor: **LSP Features:** • **Real-time Diagnostics** - Live error reporting as you type • **Comprehensive Linting** - 5 built-in rules for code quality: • Empty function detection • Empty statement detection • Variable usage validation • Unreachable code detection • Invalid syntax highlighting • **Multi-file Support** - Workspace-wide analysis • **Rich Error Messages** - Detailed explanations with code context • **Editor Integration** - Works with VS Code, Neovim, and other LSP-compatible editors Configure your editor to use as the language server for JavaScript and TypeScript files to get instant feedback on code quality. Shell Integration Generate completion scripts for your shell: Self-Updating Keep Andromeda up to date with the built-in upgrade system: Task System Andromeda includes a powerful task system inspired by Deno, allowing you to define and run custom scripts and workflows directly from your configuration file. Defining Tasks Tasks are defined in your , , or configuration file: Running Tasks Architecture & Extensions Andromeda is built with a modular architecture, allowing features to be enabled or disabled as needed: Runtime Extensions | Extension | Description | APIs Provided | | ----------------- | ----------------------------- | ------------------------------------------------------------------------------ | | **Canvas** | GPU-accelerated 2D graphics | , , with WGPU backend | | **Crypto** | Web Crypto API implementation | , , | | **Console** | Enhanced console output | , , | | **Fetch** | HTTP client capabilities | , , , | | **File System** | File I/O operations | , , directory ops | | **Local Storage** | Web storage APIs | , with persistence | | **Process** | System interaction | , , | | **SQLite** | Database operations | , prepared statements, transactions | | **Time** | Timing utilities | , , , | | **URL** | URL parsing and manipulation | , | | **Web** | Web standards | , , , | Andromeda Satellites **Satellites** are minimal, purpose-built executables designed for containerized environments and microservice architectures. Each satellite focuses on a single capability, providing smaller container images, faster startup times, and better resource utilization. Available Satellites • **andromeda-run** - Execute JavaScript/TypeScript in production containers • **andromeda-compile** - Compile JS/TS to executables • **andromeda-fmt** - Format code • **andromeda-lint** - Lint code for quality issues • **andromeda-check** - Type-check…