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.
$ 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
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.
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.
LESS PLUMBING, MORE PRODUCT
Ruby on the server.
Next.js on the screen.
Browser → Next.js → Proxy → CORS → API URL → Ruby API
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 architectureDEVELOP 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.
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.tsREADABLE BY DEFAULT
Code that gets
out of your way.
Small pieces. Familiar patterns. A generated app you can understand before lunch.
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"
endTHE 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.
READY WHEN YOU ARE
Start building
in minutes.
$ 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.