Starter is two things at once: the template every new SolRengine dApp is scaffolded
from, and a full reference app you can use today. Connect a wallet, view your tokens
with USD prices, send SOL, grab a devnet airdrop, and browse 20+ UI components in a
Lookbook gallery. It’s the Rails answer to create-solana-dapp.
Because it’s the scaffold source, anything fixed here lands in every future dApp on day one — when the SIWS security fix shipped, every app generated from Starter inherited it automatically.
What it does
- Wallet authentication via the mounted
Solrengine::Auth::Engine(SIWS, nonce-bound, rate-limited) - Dashboard with balance, address, network badge, and transaction status
- Token list showing wallet holdings with USD prices
- Send SOL form with recipient and amount
- Devnet airdrop button
- 20+ UI components from
solrengine-ui, with a Lookbook gallery at/lookbook - Dark / light mode with a theme toggle
How it’s built
- Rails 8.1, Ruby 3.3.6 — Hotwire (Turbo + Stimulus), Propshaft, esbuild, Tailwind 4
- Three processes (
web,js,css) and the four-database Solid stack - Server-side RPC — all blockchain reads in Ruby via
solrengine-rpc - Client-side signing —
@solana/kit+ Wallet Standard via@solrengine/wallet-utils bin/build-css— resolves gem paths via Bundler and scans bothsolrengine-uiandsolrengine-authviews so their Tailwind classes survive the build
Components, not from scratch
Most of the UI is assembled from solrengine-ui ViewComponents rather than hand-rolled:
| Page | Components |
|---|---|
| Layout | Footer, ThemeToggle, WalletButton, NetworkBadge |
| Dashboard | Card, Address, Balance, ExplorerLink, TransactionStatus, AirdropButton, Badge |
| Tokens | TokenList, TokenRow, TokenIcon |
| Send | SendTransactionForm |
The Lookbook gallery at /lookbook is left on in every environment on purpose — it’s a
live catalog of what you get out of the box.
The SolRengine gems behind it
- auth — SIWS wallet authentication
- rpc — balances, token accounts, transaction status
- tokens — holdings with USD prices
- programs — Anchor IDL/Borsh support, ready when you add a program
Plus solrengine-ui for the component library and Lookbook.
Start here
The fastest way to your own dApp is to clone Starter — or follow the quickstart, which walks the same path from zero to a wallet-authed app.