naofumi / rails-nextjs-erb

Gradual migration from ERB to React (or vice versa) with a Next.js - Rails BFF architecture

Rails - Next.js - ERB

Motivation

This repository is a demo project demonstrating integration of Next.js and Ruby on Rails using a BFF (Backend For Frontend) architecture.

The aim is to enable the developer to easily transition between a Next.js front-end and a Ruby on Rails ERB front-end while maintaining the same URLs and user experience. The developer will be able to swap technologies on individual pages without any externally observable differences.

This capability should enable the developer to gradually transition a website built with ERB technology to one based on React, or vice versa. Instead of a "Big-bang" style release, the developer can release each page as it is ready, one by one.

Video

Watch me demo this project!! (in Japanese) https://www.youtube.com/watch?v=KozETP3OpYA

Wiki

See the wiki to set up the demo, how to convert an existing Ruby on Rails ERB website to React, and to learn more about this project.

1. Motivation
2. Architecture
3. How it works
4. Installation (Development)
5. Directory structure
6. Other technologies
7. Form Helpers
8. Get Helpers
9. Compatibility with Hotwire/Turbo
10. Converting existing Ruby on Rails sites
11. Thoughts on APIs