Repository navigation
Home
Hakan Batuhan Kaba edited this page Nov 13, 2026
·
3 revisions
RubyToFaster (rtf) v0.2 is a minimalist, zero-dependency, script-first build system for Ruby gems. It executes the package compiler directly as a lightweight Ruby script (gem.build.rb) while integrating frontend resource pipelines, HMR + Rack static serving, topological monorepo builds, interactive HTML bundle analyzers, and supply-chain provenance inspired by Angular, Vite, and Next.js.
-
46x Faster Incremental Builds: SHA-256 Merkle caching (
.rtf-cache/) restores unchanged.gempackages in ~4.0ms (compared to ~188ms forgem build). -
Script-First Minimalist Execution: Build via
./gem.build.rb,require "rubytofaster/autorun", or inlinepkg.specblocks with zero runtime gem dependencies and shipped RBS type signatures. -
End-to-End Angular, Vite & Next.js Integration: Stage compiled bundles in-memory, pre-compress
.gzsidecars, inject live@vite/clientHMR tags in development, and serve immutable assets in production viaRubyToFaster::Middleware. -
Topological Monorepo Workspaces (
rtf workspace): Compile multi-gem repositories in parallel dependency waves. -
Bundle Treemap & Supply-Chain Security: Generate zero-CDN HTML treemap reports (
rtf analyze --html), CycloneDX 1.5 SBOMs (--sbom), and SLSA v1 provenance (--provenance).
| Guide | Summary |
|---|---|
| Getting Started | Install rubytofaster, scaffold gems with rtf new --fullstack, and run your first script build. |
| Architecture & Compiler Pipeline | Inside the in-memory deterministic packager, Merkle cache, RubyVM syntax verifier, and parallel C/Rust builder. |
| Frontend Resources: Vite, Next.js & Angular | Configure Vite, Next.js (out/ & .next/static), and Angular (angular.json) resource adapters. |
| Rack Middleware & HMR Dev Mode | Serve .gz precompressed assets with Cache-Control: immutable in production and live HMR in development. |
| Monorepo Workspaces & DAG Builds | Build multi-gem repositories in parallel topological waves (rtf workspace). |
| Bundle Analyzer, SBOM & SLSA Provenance | Visualize .gem composition (rtf analyze --html) and emit CycloneDX 1.5 SBOMs & SLSA attestations. |
| CLI & Script API Reference | Complete reference for RubyToFaster::Config, built-in Plugins, Middleware, and rtf CLI flags. |
| Security & Reproducible Builds |
SOURCE_DATE_EPOCH bit-for-bit reproducibility, path/symlink jails, and secret tree-shaking. |
| Troubleshooting & FAQ | Common questions, CI caching recipes, and diagnostics. |
RubyToFaster — Minimalist script-first Ruby gem build system by HNM Labs · MIT License · Security Policy