Migrating from Bundler

Rad is a direct, drop-in replacement for Bundler that delivers significantly improved performance without changing your workflow.

100% Bundler Compatible

Rad works with your existing Gemfile and Gemfile.lock without modifications. You can start using Rad immediately in any Ruby project without disruption.

One-Command Migration

Migrating to Rad is as simple as installing it and running your first command:

terminal

→# Install Rad

curl -LsSf https://radgems.dev/rad/install.sh | sh

Then, in your existing Ruby project:

terminal

→cd my-ruby-project && rad install

Fetching gem metadata from https://rubygems.org/...

Resolving dependencies...

Using rake 13.0.6

Using concurrent-ruby 1.2.2

Using minitest 5.18.1

Using zeitwerk 2.6.8

Using activesupport 7.1.0

...

Bundle complete! 5 Gemfile dependencies, 34 gems now installed.

Gems installed in 0.84 seconds (3.8x faster than Bundler)

That's it! No configuration needed, no changes to your project files. Just replace bundle with rad and enjoy the performance boost.

Command Equivalents

All Bundler commands have direct equivalents in Rad, making the transition effortless:

Core Commands

install

Install dependencies

3-8x faster than Bundler with cold cache

update

Update dependencies

Smarter resolution with parallel fetching

add

Add a gem to Gemfile

Includes automatic dependency resolution

delete

Delete a gem from Gemfile

Removes unused dependencies automatically

exec

Run with gems loaded

Faster project initialization than Bundler

Analysis Commands

check

Verify dependencies

Check gem compatibility in your environment

visualize

Dependency graph

Interactive visualization of your gem dependencies

stats

Project statistics

Detailed metrics about your project dependencies

platform

Platform tools

Check compatibility across platforms

env

Environment info

Show configuration and environment details

Management Commands

lock

Manage lockfile

Create or display the Gemfile.lock with improved speed

config

Configuration

Manage Rad settings and preferences

version

Version info

Display current Rad version

help

Help information

Print detailed help for any command

Usage Example

# Bundler workflow

bundle install

bundle add rspec --group=test

bundle update rails

bundle exec rspec

# Rad replacement

rad install

rad add rspec --group=test

rad update rails

rad exec rspec

Just replace bundle with rad and continue with your normal workflow.

Complete Command Reference

For a detailed guide on each command and its options, check the Command Reference section.

CI/CD Integration

Integrate Rad into your CI/CD pipelines with a simple replacement of Bundler commands:

terminal

# GitHub Actions workflow with Rad

name: Ruby Tests

on: [push, pull_request]

jobs:

test:

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v3

- name: Set up Ruby

uses: ruby/setup-ruby@v1

with:

ruby-version: 3.2

- name: Install Rad

run: |

curl -LsSf https://radgems.dev/rad/install.sh | sh

echo "$HOME/.rad/bin" >> $GITHUB_PATH

- name: Install dependencies

run: rad install

- name: Run tests

run: rad exec rspec

Rad's faster dependency resolution and installation can significantly reduce CI build times, typically by 20-50%.

Common Questions

Will Rad work with my existing Gemfile?

Yes, Rad is 100% compatible with standard Bundler Gemfiles. No changes needed.

Can I switch back and forth between Bundler and Rad?

Yes, Rad and Bundler can be used interchangeably in the same project without conflicts.

Does Rad support all Bundler features?

Yes, including Git repositories, path dependencies, platform-specific gems, and private gem servers.

How does Rad deliver better performance?

Rad uses parallel gem fetching, advanced caching, and a more efficient dependency resolver, all without compromising compatibility.