Repository navigation
Getting Started
RubyToFaster is designed to eliminate build-system ceremony. It runs on Ruby >= 3.0 with zero external runtime gem dependencies.
Install via RubyGems:
gem install rubytofasterOr add to your Gemfile:
group :development do
gem "rubytofaster"
endVerify both executables (rubytofaster and the short alias rtf):
rtf --version
# => rubytofaster 0.1.0Inside any directory containing a *.gemspec:
rtf buildCreate gem.build.rb:
#!/usr/bin/env ruby
require "rubytofaster/autorun"Run directly with Ruby:
ruby gem.build.rbGenerate a customizable gem.build.rb script using rtf init:
rtf init --vite --nextjs --angularThis creates an executable gem.build.rb file:
#!/usr/bin/env ruby
# frozen_string_literal: true
require "rubytofaster"
RubyToFaster.build do |pkg|
pkg.gemspec "my_gem.gemspec"
pkg.incremental = true
pkg.vite root: "frontend", out_dir: "dist", mount_to: "public/vite"
pkg.nextjs root: "web", mode: :auto, mount_to: "public/nextjs"
pkg.angular root: "admin", mount_to: "public/angular"
pkg.budget max_compressed_kb: 512, max_unpacked_kb: 2048
endBefore publishing to RubyGems.org, verify cryptographic SHA-256/SHA-512 checksums, inspect file modes, and audit staged frontend manifests without extracting files to disk:
rtf inspect pkg/my_gem-0.1.0.gemYou can also emit machine-readable JSON for CI checks:
rtf inspect pkg/my_gem-0.1.0.gem --jsonRubyToFaster — Minimalist script-first Ruby gem build system by HNM Labs · MIT License · Security Policy