Inertia Rails Starter Kit

A modern full-stack starter application with Rails backend and React frontend using Inertia.js based on the Laravel Starter Kit.

Features

• Inertia Rails & Vite Rails setup
• React frontend with TypeScript & shadcn/ui component library
• User authentication system (based on Authentication Zero)
• Kamal for deployment
• Optional SSR support

Setup

1. Clone this repository
2. Setup dependencies & run the server:

   bin/setup

Enabling SSR

This starter kit comes with optional SSR support. To enable it, follow these steps:

1. Open app/frontend/entrypoints/inertia.ts and uncomment part of the setup function:

   // Uncomment the following to enable SSR hydration:
   // if (el.hasChildNodes()) {
   //   hydrateRoot(el, createElement(App, props))
   //   return
   // }

2. Open config/deploy.yml and uncomment several lines:

   servers:
     # Uncomment to enable SSR:
     # vite_ssr:
     #   hosts:
     #     - 192.168.0.1
     #   cmd: bundle exec vite ssr
     #   options:
     #     network-alias: vite_ssr
      
   # ...
      
   env:
     clear:
       # Uncomment to enable SSR:
       # INERTIA_SSR_ENABLED: true
       # INERTIA_SSR_URL: "http://vite_ssr:13714"
      
   # ...
      
   builder:
     # Uncomment to enable SSR:
     # dockerfile: Dockerfile-ssr

That's it! Now you can deploy your app with SSR support.