RUBY WEB FRAMEWORK · NEXT.JS FRONTEND

Ship the product,
not the plumbing.

A fast, modular Ruby web application framework with a Next.js frontend. One command gives you a Ruby API and a TypeScript app on one origin, so you go straight to business logic.

$ gem install gemstack
Ruby 3.3+Next.jsTypeScriptRackPumaMIT
gemstack — zshTerminal

$ gemstack new shop

Creating a new GemStack application...

✓Create project structure

✓Configure Ruby API

✓Configure Next.js

✓Configure TypeScript

✓Configure one origin

✓Install dependencies


$ cd shop

$ gemstack dev

✓ Gateway on http://localhost:3000 (/api → Ruby)
⇒ Starting the Ruby API, Next.js and the jobs worker...
⇒ Your app is running at http://localhost:3000

THE SHAPE OF A GEMSTACK APP

One origin.
Zero plumbing.

Serve your Next.js frontend and Ruby API from one origin. No separate API URL. No CORS configuration. No proxy gymnastics.

Browserlocalhost:3000
GemStackGateway
Next.jsFrontend ( / )
Ruby APIRack + Puma ( /api/*, WebSockets )
ONE ORIGIN · NO CORS · NO PROXY CONFIG

One origin

Serve your Next.js frontend and Ruby API through the same origin.

Conventions without lock-in

Use familiar Ruby ecosystem technologies while keeping your structure clean and replaceable.

Typed end-to-end

Generate API contracts, OpenAPI definitions and a typed TypeScript client.

01

LESS PLUMBING, MORE PRODUCT

Ruby on the server.
Next.js on the screen.

TRADITIONAL SETUP

Browser → Next.js → Proxy → CORS → API URL → Ruby API

GEMSTACK

Browser → GemStack ↙ Next.js   ↘ Ruby API

SMALL CORE, BIG LEVERAGE

Not Rails.
Intentionally.

GemStack is a full web framework with an API-first core. Ruby handles the server, Next.js renders the UI, and there's no default User model, authentication or CRUD you didn't ask for.

Read the architecture
TRADITIONAL FULL-STACKGEMSTACK
Monolithic full-stack→Ruby API + Next.js app
Server-rendered views→Next.js frontend
Large default surface→Small modular core
Everything included→Add what you need
Convention-heavy→Convention without lock-in

DEVELOP FASTER

From idea to
vertical slice.

One command writes the migration, model, API, tests, a typed client and the Next.js pages. Keep the important parts readable.

$ gemstack generate resource Product name:string price:decimal
generated files
app/
├── controllers/
│   └── products_controller.rb
├── models/
│   └── product.rb
└── serializers/
    └── product_serializer.rb

config/routes.rb          (resources :products)

db/migrations/
└── 20261006120000_create_products.rb

test/
├── controllers/products_controller_test.rb
└── models/product_test.rb

frontend/
├── app/products/         (list, show, new, edit)
├── components/products/  (form, table, card)
└── lib/api/generated/
    └── products.ts

READABLE BY DEFAULT

Code that gets
out of your way.

Small pieces. Familiar patterns. A generated app you can understand before lunch.

010203040506
class Product < ApplicationModel
  field :name, :string, null: false, size: 255
  field :price, :decimal, null: false, gt: 0
  field :description, :text
  enum :status, %w[draft published], default: "draft"
end

THE TOOLKIT

Everything you need.
Nothing you don't.

A small, capable foundation for building real products in the Ruby ecosystem.

Fast routing

O(1) static routing keeps the request path short and predictable.

Modular architecture

Plain Rack, Bundler and Next.js underneath. Swap what you need.

Models & migrations

SQLite in development, PostgreSQL in production (MySQL works too). Fields, enums and validations declared once, used everywhere.

Jobs, mail & storage

Background jobs work from day one — gemstack dev runs the worker. Mailers and file uploads ship in the framework gem.

Typed contracts

Generate OpenAPI, TypeScript types (enums as union types) and API clients straight from your Ruby models.

Production defaults

Security headers, Brotli/gzip compression, request IDs, structured logs, JSON errors that say what failed, and one .env for the API and the frontend.

Auth & realtime

Add authentication, policies and realtime with one command: channels, presence and messages over WebSockets or Server-Sent Events.

Tests & deploys

Generated tests from day one. When you ship, bin/deploy puts the app on your own server with HTTPS and zero-downtime deploys.

FROM THE TERMINAL

One CLI. Your entire
workflow.

Create a Ruby + Next.js application

▋

YOUR ECOSYSTEM, CONNECTED

Ruby underneath.
TypeScript where it matters.

Ruby ecosystemRubyRackPumaBundlerRuby gems
GemStack
Frontend ecosystemNext.jsReactTypeScriptnpm

READY WHEN YOU ARE

Start building
in minutes.

$ gem install gemstack
$ gemstack new shop
$ cd shop
$ gemstack dev

Open http://localhost:3000

OPEN SOURCE, BUILT FOR DEVELOPERS

Build the app
you actually want.

Developed and maintained by Adware Technologies.

GemStack on GitHubMIT licensed · Issues · Contributions