Add Ruby + PostgreSQL quickstart guide

[Nsanjayboruds]

Add Ruby + PostgreSQL Quickstart Guide

📝 Description

This PR adds a comprehensive quickstart guide for Ruby (Sinatra) with PostgreSQL integration, demonstrating how to use Keploy for automated API testing with Ruby applications.

🎯 Changes Made

• ✅ Created new quickstart documentation: ruby-sinatra-postgres.md

  • Includes both Docker Compose and Local setup instructions
  • Complete CRUD API examples (GET, POST, PUT, DELETE)
  • Clear step-by-step Keploy record and test commands
  • Follows existing documentation style and structure

• ✅ Added Ruby language support to QuickStartFilter.js

  • Added Ruby gem icon with official Ruby red color (#CC342D)
  • Enables filtering quickstarts by Ruby language

• ✅ Registered quickstart in QuickStartList.js

  • Added entries for both Docker and Local environments
  • Properly linked to documentation sections

• ✅ Updated sidebar navigation in version-4.0.0-sidebars.json

  • Added Ruby category under QuickStarts section
  • Maintains consistent structure with other languages

🔗 Related Repository

Sample application repository: https://github.com/Nsanjayboruds/keploy-ruby-postgresql-quickstart

✅ Pre-submission Checklist

• Build passes locally (npm run build successful)
• Design matches existing quickstarts
• Both Docker and Local setup instructions included
• Follows existing code patterns
• Documentation is clear and beginner-friendly

📸 Preview

The quickstart covers:

• Health check endpoint
• Books CRUD operations
• PostgreSQL database integration
• Keploy record/replay workflows

🙏 Additional Notes

This is my first contribution to Keploy docs. Looking forward to feedback and happy to make any requested changes!

[Copilot]

Pull request overview

Adds a new Ruby (Sinatra) + PostgreSQL quickstart and wires it into the Quickstarts UI and sidebar so users can discover and follow the guide.

Changes:

• Added a new Ruby (Sinatra) + PostgreSQL Books CRUD quickstart doc (Docker + Local flows).
• Added “Ruby” to the Quickstart language filter UI and registered Ruby quickstart entries in the list.
• Added a Ruby category under QuickStarts in the v4.0.0 sidebar.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
versioned_sidebars/version-4.0.0-sidebars.json	Adds Ruby category + doc entry under QuickStarts for v4.0.0 navigation.
versioned_docs/version-4.0.0/quickstart/ruby-sinatra-postgres.md	New Ruby+Postgres quickstart guide content (Docker + Local).
src/components/QuickStartList.js	Registers Ruby quickstarts (Docker + Local) in the Quickstarts catalog.
src/components/QuickStartFilter.js	Adds Ruby as a selectable language with icon/color in the filter UI.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Nsanjayboruds]

@copilot open a new pull request to apply changes based on the comments in this thread

[Nsanjayboruds]

@copilot open a new pull request to apply changes based on the comments in this thread

[Achanandhi-M]

Hey @Nsanjayboruds , thanks a lot for adding the changes—really appreciate the effort. There are a few small things that still need to be added; you can use this guide as a reference: https://github.com/keploy/docs/blob/main/ADDING_A_QUICKSTART.md

Also, if possible, could you please include a short video showcasing your changes? That would be very helpful

[Nsanjayboruds]

https://drive.google.com/file/d/1pehPFehO4WpsappZzA2OQrso6IssWa1B/view?usp=sharing

[Nsanjayboruds]

Hey @Nsanjayboruds , thanks a lot for adding the changes—really appreciate the effort. There are a few small things that still need to be added; you can use this guide as a reference: https://github.com/keploy/docs/blob/main/ADDING_A_QUICKSTART.md

Also, if possible, could you please include a short video showcasing your changes? That would be very helpful

hey @Achanandhi-M i added a video showcasing my change

[Nsanjayboruds]

RUBY_QUICKSTART_DEMO

[Copilot]

Pull request overview

Copilot reviewed 4 out of 8 changed files in this pull request and generated 4 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[amaan-bhati]

Thank you for adding the Ruby Sinatra and PostgreSQL quickstart and for providing the demo video. The guide structure and content are a good start.

A few things need to be addressed before this is ready to merge:

Issues Found

1. Image filenames with spaces

The committed image files have problematic names:

• ruby quickstartdocker_Compose.png - contains a space
• ruby_keploy .png - has a trailing space before the extension

These cause URL encoding issues and are inconsistent with the repo's image naming conventions. Please rename them using only underscores or hyphens with no spaces or trailing characters.

2. QuickStartFilter.js over-reformatted

The diff shows 149 additions and 30 deletions in QuickStartFilter.js, which is far more than what adding a single Ruby entry requires. The extra formatting-only changes create unnecessary merge conflicts for other open PRs. Please revert those and keep the diff scoped to only the Ruby entry addition.

3. Outstanding items from contributing guide

Please confirm all items from ADDING_A_QUICKSTART.md have been addressed and request a re-review from the maintainer.

Please also rebase against main before resubmitting as there are merge conflicts with other open PRs touching the same files.

[Nsanjayboruds]

Sidebar duplicate comment
Thanks for checking. I re-verified this on the latest branch state and could not reproduce a duplicate sidebar entry for this page, so no removal was needed. Resolving this thread as not reproducible on current commit.

Frontmatter keyword vs keywords
Good catch, fixed. I changed frontmatter from keyword to keywords so metadata is correctly picked up. Included in the latest push.

Local flow running keploy record twice
Agreed, this was ambiguous. I updated the local flow so recording stays in a single session and clarified that health verification should be run in a separate terminal. Included in the latest push.

QuickStartFilter over-formatted / large diff
Agreed. I reverted formatting-only edits and restored QuickStartFilter formatting to match the existing file style, keeping this PR scoped to functional quickstart additions only.

Image filenames with spaces / trailing characters
Fixed. I renamed the problematic image files to clean names (no spaces or trailing characters), updated references, and removed the old filenames from the branch.

Outstanding ADDING_A_QUICKSTART checklist + rebase request
Confirmed. I addressed the checklist items for latest version quickstart integration, completed a rebase onto main, resolved conflicts, ran a successful local docs build, and pushed the updated branch. Please re-review when convenient.

[amaan-bhati]

Hey @Nsanjayboruds Thank you for the updates - the image filename fixes, frontmatter correction, revert of the formatting-only changes in QuickStartFilter.js, and the rebased branch are all appreciated. The demo videos are a good addition as well.

There are still a couple of things worth considering before this moves forward:

Issues to be Considered

1. QuickStartList.js version awareness

This has been flagged twice and has not been structurally resolved. QuickStartList.js is a shared component used across all documentation versions. The two new Ruby entries link to /docs/quickstart/samples-ruby/ which only exists in version-4.0.0. On older versioned docs these cards will appear in the UI but the links will lead to a 404. Please either make the list version-aware or add the Ruby quickstart docs to all supported versions.

2. Duplicate sidebar entry

The diff for version-4.0.0-sidebars.json shows a standalone keploy-cloud/cloud-installation entry being added outside the Installation category where it already exists. This will create a duplicate entry in the sidebar navigation. Please remove the extra standalone entry.

3. Sample app on a personal repository

The guide currently references a personal GitHub repository for the sample app. For long-term maintainability it would be better to have this hosted under the official Keploy org so the link remains stable regardless of what happens to the your personal account. Once the review is done and we are good to go, we can push these changes to a repo in the Keploy org once we have discussed this internally with the team.

[Nsanjayboruds]

Hey @Nsanjayboruds, thanks for the contribution! I tested the flow along with the docs and everything seems to be working properly — setup instructions (both Docker Compose and Local), the record/replay commands, and the CRUD endpoints all check out. Nice job for a first contribution.

One suggestion though: while the app is good and everything works, I feel the quickstart isn't really showcasing Keploy's full capabilities right now. It's a pretty small use case — just basic Books CRUD. I'd recommend taking a look at some of the other quickstarts we have to see how they demonstrate more of what Keploy can do, and then improving this one along the same lines.

Specifically:

* Expand the app logic so more operations and API calls can be performed (e.g. filtering/search, pagination, query params, validation/error cases, maybe a couple of related resources so you get dependent calls).

* Develop a traffic script of around 20 API calls that exercises these flows end-to-end, and update the doc accordingly so the recorded test set actually reflects a realistic scenario.

This would make the quickstart much more representative of how Keploy performs in a real project. Let me know if you need any pointers on the other quickstarts to reference!

Here is a professional and friendly message you can copy and paste as a reply to Dhananjay on your GitHub Pull Request:

---

Hey @dhananjay6561 ,

Thanks for the great feedback and for taking the time to test it out! You were totally right—the original basic CRUD app didn't do justice to Keploy's capabilities.

I've gone ahead and implemented your suggestions. Here are the major updates I just pushed:

1. Expanded Application Logic: I've upgraded the sample Ruby app to include much more realistic scenarios. It now handles filtering, searching, pagination, query params, and validation/error cases. I also added a dependent reviews resource connected to the books, and an analytics endpoint to demonstrate complex data aggregation.
2. Automated Traffic Script: I developed a new run-keploy.sh script that automatically starts the Keploy recording and exercises the app end-to-end with 20 diverse API calls (covering both positive flows and expected negative error cases).
3. Updated Documentation: I updated the quickstart guide to reflect this realistic scenario. Instead of asking users to manually run simple curl commands, the tutorial now guides them to use the traffic script to effortlessly generate a comprehensive test suite.

[dhananjay6561]

Hi @Nsanjayboruds, please raise a PR for your quickstart here and update the docs accordingly.

Repository: https://github.com/keploy/samples-ruby

[Nsanjayboruds]

Hi @Nsanjayboruds, please raise a PR for your quickstart here and update the docs accordingly.

Repository: https://github.com/keploy/samples-ruby

Hi @dhananjay6561,

Done! I have created the new Pull Request in the official samples-ruby repository for the expanded quickstart application (you can see it linked above).

I've also updated the markdown files in this current PR to point users to the new official repository location instead of my personal one.

Let me know if there's anything else you need me to adjust!

[dhananjay6561]

Reviewed the Ruby + PostgreSQL quickstart. The wizard rewrite (version-gated Ruby entries), the doc's slug/anchors, the QuickStartList links, and the sidebar id all line up correctly, and the local-run commands/ports match the sample app. Two things to address: a Docker replay command that drops --cmd-type docker-compose, and two committed-but-unreferenced screenshots. Details inline.

[Nsanjayboruds]

Hey @dhananjay6561 , thanks for the detailed review! Here's what I've fixed:

Docker replay command — Added the missing --cid-type docker-compose flag to the keploy test command in the Docker section. Delay flags (--buildDelay 50 --delay 10) are already consistent and unchanged.
Unreferenced images — Removed static/img/ruby_keploy.png (~98KB) and static/img/ruby_quickstart_docker_compose.png (~132KB) from the repo. The two images that are actually referenced in the doc (ruby_testcase.png and ruby_postgres_docker_setup.png) have been kept.

[dhananjay6561]

A couple of notes on the local setup steps, inline.

[dhananjay6561]

One more on the language picker, inline.

[Nsanjayboruds]

Hey @dhananjay6561, addressed the two new rounds of feedback:
Local setup steps:

• Replaced cp .env.example .env with explicit export DB_... instructions, since the app reads configuration directly from environment variables and doesn't use the dotenv gem.
• Updated createdb booksdb to createdb -U postgres booksdb, with a preceding step to create the postgres role if it doesn't exist. This ensures /health doesn't return 503 on a fresh local PostgreSQL installation where that role isn't provisioned.

Language picker accessibility:

• Added type="button" to all wizard option <button> elements in both the language (step 1) and environment (step 2) pickers to prevent accidental form submission.
• Added role="radio" and aria-checked={...} to properly communicate the single-select state to screen readers.