rcli_app

A turnkey Ruby gem that scaffolds a complete CLI starter project in one command. Install, run rcli_app new, and get a preconfigured app with ActiveRecord, SQLite, Faker, and RSpec—no boilerplate, just code.
Ruby Gems logo

Overview

During my time at Flatiron School in the Covid-19 cohort, I noticed that many new Rubyists—including myself—spent more time wrestling with boilerplate and configuration than actually learning core language and OOP concepts. rcli_app solves this by scaffolding a fully functional command-line application in one step: install the gem, run rcli_app new, and you immediately get a project prewired with ActiveRecord (for ORM), SQLite (for a lightweight database), Faker (for seed data), and RSpec (for testing). The generated directory structure follows best practices, complete with example commands, a simple CLI parser, and a basic test suite—so beginners can dive straight into writing Ruby code instead of buying another round of coffee while staring at a blank terminal. Since release, rcli_app has garnered praise for its developer experience and has been downloaded over 1,800 times, helping countless bootcamp students bypass setup headaches and focus on learning.

Role
  • Designer
  • Backend Developer
Duration
1 weeks
Tags
  • Community
  • Education
  • Open Source
Problems

Problem Framing

Framing the problem first helps us focus on the real user need instead of jumping to solutions. Here’s the distilled who/when/where/why.
Who
🤔
Beginner Ruby students at bootcamps or self-learners.
When
📍
When they tackle their first command-line app assignments and struggle with setup.
Where
In local development environments running Ruby scripts and CLI projects.
Why
❤️
Existing tutorials force learners to write repetitive config and gem setup, causing frustration and blocking OOP understanding.

The Goal

rcli_app installs with a single command and generates a turnkey CLI scaffold prewired with ActiveRecord, SQLite, Faker, and RSpec so beginners can dive straight into Ruby and OOP concepts.

Insights

Three focus areas to improve rcli_app’s developer experience.
🤔
  • Command Discovery
    New users often couldn’t find or remember the generated subcommands (e.g. rcli_app new vs. bundle exec rcli_app new), leading them to search docs instead of diving into code.
  • Configuration Awareness
    The default SQLite setup overshadowed instructions for swapping databases or adding gems, so many users weren’t aware they could customize their stack.
  • Output Accessibility
    Colorized terminal messages used low-contrast ANSI codes, making prompts and errors hard to read for color-blind users and those on dark backgrounds.
Outcomes

Outcomes

The rcli_app gem launches a full starter app with one command. It’s been downloaded over 2000 times on RubyGems and garnered praise from Flatiron instructors and peers for smoothing the learning curve.
Retention
🔁
100%
Cohort-mates rated install as "very easy" and used it in their projects
Adoption
🚀
2000+
download via RubyGems
Efficiency
80%
reduction in initial setup time for new users