jimmu 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6fd8e1e08377f2b4c7790010cc672bde1c412453fdcef70b726527ac38da488e
+  data.tar.gz: 386d566253e29f4812a6a1e6cea8e8e1b54c12bff8a13b805856879ee54b68b2
+SHA512:
+  metadata.gz: 8c63c33170e4b00bc12a974e8f15381edf7a56e8b539b6dacc888afeb8de27e601dd8b2d15b27bc2e9464d344fed9a6db711b2c7e87009ff9f2859312df7cf5a
+  data.tar.gz: db14fb9673208ce1a80f49627bf214a014e56cd16f8adf39014019fbc52363ea1f112b2280ff1380dae15cac4c84b2dd311014276eda454289360d61ac9e2550

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Araki-Tomoya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,279 @@
+# Jimmu (神武)
+
+A lightweight Ruby web framework. Full-featured but simple: ERB, SQLite,
+file-based routing, and WebSockets in one file, so you can go from
+nothing to a working small web app in minutes.
+
+```
+gem install jimmu
+jimmu new myapp
+cd myapp
+jimmu server
+```
+
+Then visit `http://127.0.0.1:3000/`.
+
+## Why
+
+- **One file.** The entire framework is `lib/jimmu.rb`. Nothing to configure,
+  nothing to generate boilerplate for.
+- **No native gem dependencies.** SQLite support talks directly to your
+  system's `libsqlite3` via Ruby's built-in `Fiddle` library -- there's no
+  `sqlite3` gem, so there's no native extension to compile when you install.
+  Everything else is Ruby standard library.
+- **A file is a page.** Drop a `.erb` file under `views/` and it's routable.
+  No router config, no controller classes.
+
+## Installing
+
+```
+gem install jimmu
+```
+
+Requires Ruby >= 2.7 and a system SQLite3 shared library, which ships with
+macOS and is available via your package manager on Linux
+(`apt install libsqlite3-0`, `dnf install sqlite-libs`, etc.) and typically
+already present with Ruby installations on Windows.
+
+## The CLI
+
+| Command | Effect |
+|---|---|
+| `jimmu new <name>` | Create a new project in `./<name>` |
+| `jimmu server` | Start the dev server, reading `./app.rb` |
+| `jimmu server -p 8080` | ...on a specific port (overrides `port` in app.rb) |
+| `jimmu server -h 0.0.0.0` | ...on a specific host (overrides `host` in app.rb) |
+| `jimmu version` | Print the installed version |
+| `jimmu help` | Show usage |
+
+## Project layout
+
+```
+myapp/
+├── app.rb              # entry point -- config, hooks, then `run`
+├── views/
+│   ├── layout.erb       # auto-applied around every page unless disabled
+│   ├── index.erb        # ->  /
+│   ├── 404.erb           # shown on 404
+│   └── 500.erb           # shown on unhandled errors
+├── public/
+│   ├── css/style.css    # ->  /css/style.css
+│   ├── js/app.js         # ->  /js/app.js
+│   └── img/
+└── db/                   # SQLite files live here by convention
+```
+
+## File-based routing
+
+A file's path under `views/` becomes its URL. `index.erb` files match their
+parent directory:
+
+```
+views/index.erb              ->  /
+views/about.erb               ->  /about
+views/blog/index.erb          ->  /blog
+views/blog/post.erb           ->  /blog/post
+```
+
+Square brackets make a segment dynamic and land in `params`:
+
+```
+views/user/[id].erb                  ->  /user/:id            params[:id]
+views/post/[category]/[id].erb       ->  /post/:category/:id  params[:category], params[:id]
+```
+
+A literal file always wins over a dynamic one at the same level (so
+`views/user/admin.erb` would take priority over `views/user/[id].erb` for
+`/user/admin` specifically, while every other value still hits the dynamic
+route).
+
+Every HTTP method routes through the same file -- check `request.method`
+inside the template to branch between, say, showing a form on `GET` and
+handling its submission on `POST` to the same path.
+
+## Inside a view
+
+Each `.erb` file has access to:
+
+```ruby
+params[:id]                    # route + query + form + JSON body params (merged)
+request.method                 # "GET", "POST", ...
+request.path                   # "/user/42"
+request.ip                     # client IP
+request.header("user-agent")   # any request header, by lowercase name
+request.query_params           # just the ?query=string part
+cookie[:theme]                 # read a cookie
+cookie[:theme] = "dark"        # queue a Set-Cookie
+session[:user_id]              # read/write server-side session data
+                                # (survives across requests via a cookie;
+                                # cleared with session.clear or session.delete(:k))
+
+status 404                     # set the response status (doesn't stop rendering)
+header "X-Custom", "value"     # set a response header
+
+redirect "/login"              # 302 and stop
+json(ok: true)                 # render JSON and stop
+text "plain text"              # render text/plain and stop
+html "<b>hi</b>"                # render text/html and stop
+render "other_view"            # render another view (through the layout) and stop
+
+layout false                   # skip views/layout.erb for this render
+
+log "message"                  # timestamped line on the server console
+db                              # the most recently opened `sqlite` connection
+```
+
+`redirect` / `json` / `text` / `html` / `render` all end the current
+template immediately -- nothing written after them in the same `.erb` file
+runs.
+
+### Layouts
+
+`views/layout.erb` wraps every page automatically; put `<%= yield %>` where
+the page's own content should go. Turn it off per-page with `<% layout false %>`
+anywhere in that page's template.
+
+### Errors
+
+`views/404.erb` renders on an unmatched route; `views/500.erb` renders on an
+unhandled exception (it can read `error.message` / `error.backtrace` if you
+want to show details, or just show a friendly message). You can also trigger
+either one yourself:
+
+```erb
+<% unless post
+     status 404
+     render "404"   # note: a string, not :404 -- see "Gotchas" below
+   end %>
+```
+
+If neither file exists, Jimmu shows its own built-in page -- a plain message
+for 404, and a full backtrace for 500 (since that's only ever seen when you
+haven't set up your own error page, it defaults to maximally useful rather
+than maximally polished).
+
+### SQLite
+
+```ruby
+# in app.rb
+db = sqlite "db/app.db"
+db.exec("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT)")
+```
+
+```erb
+<%# in any view %>
+<% users = db.query("SELECT * FROM users WHERE name = ?", params[:name]) %>
+<% db.exec("INSERT INTO users(name) VALUES (?)", params[:name]) %>
+<% db.transaction do
+     db.exec("...")
+     db.exec("...")
+   end %>
+```
+
+`query` returns an Array of Hashes with Symbol keys. `exec` returns the
+number of rows changed. `db.last_insert_rowid` gives you the last
+auto-increment id. `?` placeholders are the only supported binding style;
+always use them for anything that includes user input.
+
+### File uploads
+
+```erb
+<form method="post" enctype="multipart/form-data">
+  <input type="file" name="avatar">
+</form>
+```
+```erb
+<% file = params[:avatar]
+   file.filename        # "photo.png"
+   file.content_type    # "image/png"
+   file.size             # bytes
+   file.save("public/uploads/photo.png") %>
+```
+
+### WebSockets
+
+Registered in `app.rb`, separately from the file-based view routes:
+
+```ruby
+websocket "/ws/[room]" do
+  log "opened: #{params[:room]}"
+  on_message { |msg| send("echo: #{msg}") }
+  on_close   { log "closed" }
+end
+```
+
+Inside the block (and inside `on_message` / `on_close`), `self` is the
+connection, so `send`, `close`, `params`, `session`, `cookie`, `request`,
+`log`, and `db` are all available directly. There's no special "broadcast"
+method -- see `examples/chatroom` and `examples/poll` for the few lines of
+plain Ruby (a shared Array/Hash + Mutex) it takes to build one yourself.
+
+### Hooks
+
+```ruby
+before do
+  log "#{request.method} #{request.path}"
+end
+
+after do
+  header "X-Powered-By", "Jimmu"
+end
+```
+
+`before` runs ahead of every request (including static files); calling
+`redirect`/`json`/etc. inside one stops the request right there, which is
+enough to build things like auth gates. `after` runs once a response body
+has been produced.
+
+## Gotchas
+
+- **`render "404"`, not `render :404`.** `:404` isn't valid Ruby (a bare
+  symbol can't start with a digit) -- use a String for view names that start
+  with a number.
+- **Helpers belong at the true top level of app.rb.** `def my_helper` /
+  `MY_CONST = ...` / `module Helpers ... end` written directly in app.rb are
+  ordinary top-level Ruby and are callable from anywhere -- views,
+  `before`/`after`, `websocket` blocks. (Concretely: app.rb is `load`ed as a
+  normal file, not stringwise `eval`'d, specifically so this works.)
+- **Sessions are in-memory.** They reset when the server restarts. Fine for
+  development and small apps; swap in a database-backed store yourself if
+  you need durability.
+- **One request per connection.** Keep-alive isn't implemented -- each HTTP
+  request gets its own TCP connection, which keeps the server simple. This
+  doesn't apply to WebSocket connections, which stay open as long as the
+  client does.
+- **No chunked request bodies.** Incoming requests are read via
+  `Content-Length`; chunked `Transfer-Encoding` on requests isn't parsed
+  (this practically never comes up for browser form posts or `fetch()`).
+
+## Examples
+
+Twelve complete apps in `examples/`, each `jimmu server`-able as-is:
+
+| Example | Shows off |
+|---|---|
+| `hello-world` | The absolute minimum, plus one dynamic route |
+| `bbs` | A message board -- SQLite, forms, session-remembered name |
+| `chatroom` | Named chat rooms over WebSocket, with a hand-rolled broadcast |
+| `todo` | SQLite CRUD via small per-action routes |
+| `blog` | Posts list/detail, `/post/[id]`, a create form, custom 404 |
+| `counter` | A JSON API endpoint called from client-side `fetch()` |
+| `url-shortener` | Dynamic redirect route, plus a JSON API to create links |
+| `visitor-counter` | `before` hook + cookie to tell new vs. returning visitors |
+| `image-upload` | `multipart/form-data`, saving into `public/`, a gallery |
+| `poll` | WebSocket used to push live results to every open tab |
+| `json-api` | A headless JSON REST API (no HTML views at all) |
+| `login-demo` | Session-based auth with a `before`-hook route guard |
+
+```
+cd examples/chatroom
+jimmu server
+```
+
+(If you're running straight from this source checkout rather than an
+installed gem, use `ruby -I../../lib ../../exe/jimmu server` instead, or
+`gem install --local` the built `.gem` first.)
+
+## License
+
+MIT. See `LICENSE`.

data/examples/bbs/app.rb

@@ -0,0 +1,21 @@
+# Simple bulletin board (BBS).
+# Demonstrates: SQLite, forms/POST, session (remembers your name),
+# before hook, file-based routing.
+
+port 3000
+
+db = sqlite "db/bbs.db"
+db.exec <<~SQL
+  CREATE TABLE IF NOT EXISTS posts (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    author TEXT NOT NULL,
+    body TEXT NOT NULL,
+    created_at TEXT NOT NULL
+  )
+SQL
+
+before do
+  log "#{request.method} #{request.path}"
+end
+
+run

data/examples/bbs/public/css/style.css

@@ -0,0 +1,15 @@
+:root{color-scheme:light dark}
+*{box-sizing:border-box}
+body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;background:#f4f5f7;margin:0;color:#1a1a1a}
+.wrap{max-width:640px;margin:0 auto;padding:32px 20px}
+header h1{font-size:20px}
+header h1 a{color:inherit;text-decoration:none}
+.post-form{display:flex;flex-direction:column;gap:8px;background:#fff;padding:16px;border-radius:10px;box-shadow:0 1px 3px rgba(0,0,0,.08);margin-bottom:20px}
+.post-form input,.post-form textarea{font:inherit;padding:10px;border:1px solid #ddd;border-radius:6px;width:100%}
+.post-form textarea{min-height:80px;resize:vertical}
+.post-form button{align-self:flex-end;background:#3b6fe0;color:#fff;border:0;padding:10px 20px;border-radius:6px;cursor:pointer;font-weight:600}
+.count{color:#777;font-size:13px}
+.posts{list-style:none;padding:0;display:flex;flex-direction:column;gap:10px}
+.post{background:#fff;padding:14px 16px;border-radius:10px;box-shadow:0 1px 3px rgba(0,0,0,.06)}
+.post-meta{font-size:12px;color:#888;margin-bottom:6px}
+.post-body{white-space:pre-wrap;word-break:break-word}

data/examples/bbs/views/404.erb

@@ -0,0 +1 @@
+<h1>404</h1><p><a href="/">Home</a></p>

data/examples/bbs/views/500.erb

@@ -0,0 +1 @@
+<h1>500</h1><p>Something went wrong.</p>

data/examples/bbs/views/index.erb

@@ -0,0 +1,29 @@
+<%
+  if request.method == "POST"
+    author = params[:author].to_s.strip
+    body_text = params[:body].to_s.strip
+    author = "Anonymous" if author.empty?
+    session[:author] = author
+    unless body_text.empty?
+      db.exec("INSERT INTO posts(author, body, created_at) VALUES (?, ?, ?)", author, body_text, Time.now.strftime("%Y-%m-%d %H:%M:%S"))
+    end
+    redirect "/"
+  end
+  posts = db.query("SELECT * FROM posts ORDER BY id DESC")
+%>
+<form method="post" action="/" class="post-form">
+  <input type="text" name="author" placeholder="Your name" value="<%= session[:author] %>">
+  <textarea name="body" placeholder="Write something..." required></textarea>
+  <button type="submit">Post</button>
+</form>
+
+<p class="count"><%= posts.length %> post<%= posts.length == 1 ? "" : "s" %></p>
+
+<ul class="posts">
+<% posts.each do |post| %>
+  <li class="post">
+    <div class="post-meta"><strong><%= CGI.escapeHTML(post[:author]) %></strong> &middot; <%= post[:created_at] %></div>
+    <div class="post-body"><%= CGI.escapeHTML(post[:body]).gsub("\n", "<br>") %></div>
+  </li>
+<% end %>
+</ul>

data/examples/bbs/views/layout.erb

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Jimmu BBS</title>
+<link rel="stylesheet" href="/css/style.css">
+</head>
+<body>
+<div class="wrap">
+<header><h1><a href="/">Jimmu BBS</a></h1></header>
+<%= yield %>
+</div>
+</body>
+</html>

data/examples/blog/app.rb

@@ -0,0 +1,28 @@
+# Minimal blog.
+# Demonstrates: SQLite, dynamic routes (/post/[id]), a create form,
+# 404 for missing posts, layout.
+
+port 3000
+
+db = sqlite "db/blog.db"
+db.exec <<~SQL
+  CREATE TABLE IF NOT EXISTS posts (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    title TEXT NOT NULL,
+    body TEXT NOT NULL,
+    created_at TEXT NOT NULL
+  )
+SQL
+
+if db.query("SELECT COUNT(*) AS c FROM posts").first[:c].zero?
+  db.exec("INSERT INTO posts(title, body, created_at) VALUES (?, ?, ?)",
+    "Welcome to Jimmu",
+    "This is your first post. Edit it, delete it, or write a new one from /new.\n\nJimmu renders this body with basic paragraph formatting -- try leaving a blank line between paragraphs.",
+    Time.now.strftime("%Y-%m-%d %H:%M"))
+end
+
+before do
+  log "#{request.method} #{request.path}"
+end
+
+run

data/examples/blog/public/css/style.css

@@ -0,0 +1,18 @@
+:root{color-scheme:light dark}
+*{box-sizing:border-box}
+body{font-family:Georgia,"Times New Roman",serif;background:#fffdf9;color:#2a2a2a;margin:0}
+.wrap{max-width:640px;margin:0 auto;padding:40px 20px}
+header{display:flex;justify-content:space-between;align-items:baseline;border-bottom:2px solid #222;padding-bottom:14px;margin-bottom:24px;font-family:-apple-system,sans-serif}
+header h1{font-size:22px;margin:0}
+header h1 a{color:inherit;text-decoration:none}
+.new-link{font-size:13px;color:#3b6fe0;text-decoration:none}
+.post-list{list-style:none;padding:0;display:flex;flex-direction:column;gap:18px}
+.post-list .title{font-size:19px;color:#1a1a1a;text-decoration:none;font-weight:bold}
+.post-list .date{font-size:13px;color:#888;font-family:-apple-system,sans-serif;margin-top:2px}
+article .date{font-size:13px;color:#888;font-family:-apple-system,sans-serif;margin-bottom:20px}
+article .body p{line-height:1.8;font-size:17px}
+.post-form{display:flex;flex-direction:column;gap:10px;font-family:-apple-system,sans-serif}
+.post-form input,.post-form textarea{font:inherit;padding:10px;border:1px solid #ccc;border-radius:6px}
+.post-form textarea{min-height:220px;font-family:Georgia,serif;font-size:15px}
+.post-form button{align-self:flex-start;background:#222;color:#fff;border:0;padding:10px 22px;border-radius:6px;cursor:pointer}
+a{color:#3b6fe0}

data/examples/blog/views/404.erb

@@ -0,0 +1 @@
+<h1>404</h1><p>That post doesn't exist.</p><p><a href="/">&larr; all posts</a></p>

data/examples/blog/views/500.erb

@@ -0,0 +1 @@
+<h1>500</h1>

data/examples/blog/views/index.erb

@@ -0,0 +1,9 @@
+<% posts = db.query("SELECT * FROM posts ORDER BY id DESC") %>
+<ul class="post-list">
+<% posts.each do |post| %>
+  <li>
+    <a class="title" href="/post/<%= post[:id] %>"><%= CGI.escapeHTML(post[:title]) %></a>
+    <div class="date"><%= post[:created_at] %></div>
+  </li>
+<% end %>
+</ul>

data/examples/blog/views/layout.erb

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Jimmu Blog</title>
+<link rel="stylesheet" href="/css/style.css">
+</head>
+<body>
+<div class="wrap">
+<header><h1><a href="/">Jimmu Blog</a></h1><a class="new-link" href="/new">+ New post</a></header>
+<%= yield %>
+</div>
+</body>
+</html>

data/examples/blog/views/new.erb

@@ -0,0 +1,18 @@
+<%
+  if request.method == "POST"
+    title = params[:title].to_s.strip
+    body_text = params[:body].to_s.strip
+    if title.empty? || body_text.empty?
+      status 422
+    else
+      db.exec("INSERT INTO posts(title, body, created_at) VALUES (?, ?, ?)", title, body_text, Time.now.strftime("%Y-%m-%d %H:%M"))
+      redirect "/"
+    end
+  end
+%>
+<h2>New post</h2>
+<form method="post" action="/new" class="post-form">
+  <input type="text" name="title" placeholder="Title" required value="<%= CGI.escapeHTML(params[:title].to_s) %>">
+  <textarea name="body" placeholder="Write your post..." required><%= CGI.escapeHTML(params[:body].to_s) %></textarea>
+  <button type="submit">Publish</button>
+</form>

data/examples/blog/views/post/[id].erb

@@ -0,0 +1,17 @@
+<%
+  post = db.query("SELECT * FROM posts WHERE id = ?", params[:id]).first
+  unless post
+    status 404
+    render "404"
+  end
+%>
+<article>
+  <h2><%= CGI.escapeHTML(post[:title]) %></h2>
+  <div class="date"><%= post[:created_at] %></div>
+  <div class="body">
+  <% post[:body].split("\n\n").each do |para| %>
+    <p><%= CGI.escapeHTML(para) %></p>
+  <% end %>
+  </div>
+</article>
+<p><a href="/">&larr; all posts</a></p>

data/examples/chatroom/app.rb

@@ -0,0 +1,44 @@
+# Named chat rooms over WebSocket.
+# Pick a name, create (or join) a room, chat in real time.
+# Demonstrates: WebSocket, dynamic routing, request.query_params,
+# a hand-rolled broadcast registry built from plain Ruby (Jimmu has
+# no special "broadcast" API -- this is all you need to build one).
+
+port 3000
+
+ROOMS = Hash.new { |h, k| h[k] = [] }
+ROOMS_LOCK = Mutex.new
+
+def broadcast(room, message)
+  ROOMS_LOCK.synchronize { ROOMS[room].dup }.each do |conn|
+    conn.send(message) if conn.open?
+  end
+end
+
+before do
+  log "#{request.method} #{request.path}"
+end
+
+websocket "/ws/[room]" do
+  room = params[:room]
+  name = request.query_params[:name].to_s
+  name = "Guest#{rand(1000)}" if name.strip.empty?
+
+  ROOMS_LOCK.synchronize { ROOMS[room] << self }
+  broadcast(room, { type: "system", text: "#{name} joined the room.", count: ROOMS[room].length }.to_json)
+  log "chat: #{name} joined ##{room} (#{ROOMS[room].length} online)"
+
+  on_message do |raw|
+    text = raw.to_s[0, 2000]
+    next if text.strip.empty?
+    broadcast(room, { type: "message", author: name, text: text }.to_json)
+  end
+
+  on_close do
+    ROOMS_LOCK.synchronize { ROOMS[room].delete(self) }
+    broadcast(room, { type: "system", text: "#{name} left the room.", count: ROOMS[room].length }.to_json)
+    log "chat: #{name} left ##{room}"
+  end
+end
+
+run

data/examples/chatroom/public/css/style.css

@@ -0,0 +1,15 @@
+:root{color-scheme:light dark}
+*{box-sizing:border-box}
+body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;background:#0f1115;color:#e7e8ec;margin:0}
+.wrap{max-width:560px;margin:0 auto;padding:32px 20px}
+.center{text-align:center;padding-top:80px}
+form{display:flex;gap:8px;margin-top:20px}
+input{flex:1;padding:12px;border-radius:8px;border:1px solid #333;background:#1a1d24;color:#fff;font-size:15px}
+button{padding:12px 18px;border-radius:8px;border:0;background:#5865f2;color:#fff;font-weight:600;cursor:pointer}
+.chat h1{display:flex;align-items:center;gap:10px;font-size:20px}
+.badge{font-size:12px;color:#9aa0ab;font-weight:400}
+.log{height:50vh;overflow-y:auto;background:#1a1d24;border-radius:10px;padding:14px;margin-bottom:14px;display:flex;flex-direction:column;gap:6px}
+.line{font-size:14px;line-height:1.5;word-break:break-word}
+.line.system{color:#7a8093;font-style:italic;font-size:13px}
+.line.message strong{color:#8ab4ff}
+a{color:#8ab4ff}

data/examples/chatroom/views/404.erb

@@ -0,0 +1 @@
+<div class="wrap center"><h1>404</h1><p><a href="/">Home</a></p></div>

data/examples/chatroom/views/500.erb

@@ -0,0 +1 @@
+<div class="wrap center"><h1>500</h1></div>

data/examples/chatroom/views/index.erb

@@ -0,0 +1,18 @@
+<div class="wrap center">
+  <h1>Jimmu Chat</h1>
+  <p>Pick a name and a room. If the room doesn't exist yet, it's created the moment you join.</p>
+  <form id="join-form">
+    <input type="text" id="name" placeholder="Your name" required maxlength="24">
+    <input type="text" id="room" placeholder="Room name (e.g. lobby)" required maxlength="24">
+    <button type="submit">Join room</button>
+  </form>
+</div>
+<script>
+document.getElementById('join-form').addEventListener('submit', function (e) {
+  e.preventDefault();
+  var name = document.getElementById('name').value.trim();
+  var room = document.getElementById('room').value.trim().toLowerCase().replace(/[^a-z0-9_-]/g, '-');
+  if (!name || !room) return;
+  window.location.href = '/room/' + encodeURIComponent(room) + '?name=' + encodeURIComponent(name);
+});
+</script>

data/examples/chatroom/views/layout.erb

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Jimmu Chat</title>
+<link rel="stylesheet" href="/css/style.css">
+</head>
+<body>
+<%= yield %>
+</body>
+</html>