Tina4 Ruby - Quick Reference#

# Install the tina4 CLI once. Windows: irm https://tina4.com/install.ps1 | iexcurl -fsSL https://tina4.com/install.sh | sh​tina4 init ruby my-appcd my-apptina4 serve

<!-- src/templates/index.html --><h1>Hello Static World</h1>

Tina4::Router.get("/") do |request, response|  response.html "<h1>Hello Tina4 Ruby</h1>"end​Tina4::Router.post("/api/items") do |request, response|  name = request.body["name"] || ""  response.json({ name: name }, 201)end​Tina4::Router.get("/users/{id:int}") do |request, response|  id = request.params[:id]  response.json({ user_id: id })end

log_request = lambda do |request, response, next_handler|  $stderr.puts "#{request.method} #{request.path}"  next_handler.call(request, response)end​Tina4::Router.get("/api/data", middleware: "log_request") do |request, response|  response.json({ data: [1, 2, 3] })end​# Apply middleware to a groupTina4::Router.group("/api/admin", middleware: "require_auth") do  Tina4::Router.get("/dashboard") do |request, response|    response.json({ page: "admin dashboard" })  endend

<!-- src/templates/greeting.html --><h1>Hello {{ name }}</h1>

Tina4::Router.get("/") do |request, response|  response.render("greeting.html", { name: "World" })end

Tina4::Router.get("/session/set") do |request, response|  request.session.set("name", "Joe")  request.session.set("info", { list: ["one", "two", "three"] })  response.text "Session set."end​Tina4::Router.get("/session/get") do |request, response|  name = request.session.get("name", "Guest")  info = request.session.get("info", {})  response.json({ name: name, info: info })end

// src/public/scss/main.scss$primary: #2c3e50;body {  background: $primary;  color: white;}

TINA4_DEBUG=trueTINA4_PORT=7147TINA4_DATABASE_URL=sqlite:///data/app.dbTINA4_LOG_LEVEL=ALLTINA4_API_KEY=ABC1234

api_key = ENV["TINA4_API_KEY"] || "ABC1234"

Tina4::Env.load_env                          # Load .env file (auto on server start)Tina4::Env.get_env("TINA4_DATABASE_URL")           # Get value or nilTina4::Env.get_env("PORT", "7147")           # Get value with defaultTina4::Env.has_env?("TINA4_DEBUG")           # true if setTina4::Env.require_env!("TINA4_DATABASE_URL")      # Raises KeyError if missingTina4::Env.truthy?(ENV["TINA4_DEBUG"])       # true for "true", "1", "yes"

# Public login routeTina4::Router.post("/login") do |request, response|  token = Tina4::Auth.get_token({ user_id: 1, role: "admin" })  response.json({ token: token })end​# Secured GET route (chain .secure)Tina4::Router.get("/api/profile") do |request, response|  response.json({ user: request.user })end.secure​# Or use the @secured decorator# @securedTina4::Router.get("/api/account") do |request, response|  response.json({ account: request.user })end

<form method="POST" action="/register">    <input name="email">    <button>Save</button></form>

# List all users# @description Returns all registered users# @tags Users# @query int $page Page number (default: 1)Tina4::Router.get("/api/users") do |request, response|  response.json({ users: [] })end

# Configured via .env (default: sqlite:///data/app.db)# Or create a connection in code:db = Tina4::Database.new("sqlite://app.db")db = Tina4::Database.new("postgres://localhost:5432/myapp", pool: 5)

result = db.fetch("SELECT * FROM users", [], limit: 3, skip: 1)​array = result.to_a        # Array of hashesjson  = result.to_json     # JSON stringcsv   = result.to_csv      # CSV string

tina4 migrate --create create_users_table

-- src/migrations/20260313120000_create_users_table.sqlCREATE TABLE users (    id   INTEGER PRIMARY KEY AUTOINCREMENT,    name TEXT);

tina4 migrate

class User < Tina4::ORM  integer_field :id, primary_key: true  string_field  :name  string_field  :email​  table_name "users"end​user = User.newuser.name = "Alice"user.email = "alice@example.com"user.save​found = User.find(1)found.name = "Alice Wonder"found.save

Tina4::Router.get("/users/dashboard") do |request, response|  users = User.all  response.render("users/dashboard.html", { users: users })end

api = Tina4::API.new("https://api.example.com", auth_header: "Bearer xyz")result = api.get("/users/42")puts result.body

require "tina4"​RSpec.describe "Math operations" do  it "adds numbers" do    expect(2 + 2).to eq(4)  endend

class CacheWarmer < Tina4::Service  def run    Tina4::Log.info("Warming cache...")    # Your background work here    sleep 60  endend​Tina4::ServiceRunner.register(CacheWarmer.new)Tina4::ServiceRunner.start_all

Tina4::Router.websocket "/ws/echo" do |connection, event, data|  if event == :message    connection.send("Echo: #{data}")  endend

queue = Tina4::Queue.new(topic: "emails")​queue.push({  to: "alice@example.com",  subject: "Welcome",  body: "Your account is ready."})

class Calculator < Tina4::WSDL  service_url "http://localhost:7147/calculator"​  def add(a, b)    { result: a + b }  endend

schema = Tina4::GraphQLSchema.newgql = Tina4::GraphQL.new(schema)gql.register_route  # POST /graphql, GET /graphql (playground)

{ users(limit: 5) { id name email } }

puts Tina4.t("server_stopped")  # "Server stopped." (en)

el = Tina4::HtmlElement.new("div", { class: "card" }, ["Hello"])el.to_s  # => '<div class="card">Hello</div>'​# Nesting with callcard = Tina4::HtmlElement.new("div").call(  { class: "card" },  Tina4::HtmlElement.new("h2").call("Title"),  Tina4::HtmlElement.new("p").call("Content"),)​# Helper methodsinclude Tina4::HtmlHelpershtml = _div({ class: "card" }, _h1("Title"), _p("Description"))

# Subscribe to an eventTina4::Events.on("user.created") do |payload|  puts "New user: #{payload[:name]}"end​# Subscribe once - auto-removes after first fireTina4::Events.once("app.boot") do |payload|  puts "App booted at #{payload[:time]}"end​# Emit an event anywhere in the appTina4::Events.emit("user.created", { name: "Alice", id: 42 })

Tina4::Log.info("Server ready on port 7147")Tina4::Log.debug("Params: #{request.params.inspect}")Tina4::Log.warning("Deprecated method called")Tina4::Log.error("Database connection failed")

# Cache for 60 seconds (default)Tina4::Router.get("/api/products") do |request, response|  response.json({ products: Product.all })end.cache​# Custom TTL in secondsTina4::Router.get("/api/summary") do |request, response|  response.json({ total: Order.count })end.cache(300)​# Cache is keyed on method + path + query string.# Clear all cached responses:Tina4::Cache.flush

curl http://localhost:7147/health

{ "status": "ok", "uptime": 142, "version": "3.10.20" }

# Register a service by nameTina4::Container.register(:mailer) { Mailer.new(ENV["TINA4_MAIL_HOST"]) }​# Register a singleton (resolved once, reused everywhere)Tina4::Container.register(:config, singleton: true) { AppConfig.load }​# Resolve anywhere in the appmailer = Tina4::Container.resolve(:mailer)mailer.send_welcome(user)

TINA4_DEBUG=true

http://localhost:7147/__dev

tina4 init ruby my-project   # Scaffold a new Ruby projecttina4 serve                  # Start dev server (port 7147, live reload)tina4 serve --port 8080      # Custom porttina4 migrate                # Run pending SQL migrationstina4 migrate --create name  # Generate a timestamped migration filetina4 test                   # Run the RSpec test suitetina4 build                  # Compile SCSS, bundle assets for productiontina4 routes                 # Print all registered routes to stdout

http://localhost:7147/__mcp

# Register a custom MCP toolTina4::MCP.register_tool("get_user") do |params|  user = User.find(params["id"].to_i)  { id: user.id, name: user.name }end

fake = Tina4::FakeData.new​puts fake.name          # "Liam Torres"puts fake.email         # "liam.torres@example.com"puts fake.phone         # "+1-555-0147"puts fake.address       # "12 Elm Street, Springfield"puts fake.company       # "Bright Horizon Ltd"puts fake.paragraph     # Lorem-style filler textputs fake.integer(1, 100) # Random integer between 1 and 100puts fake.uuid          # "a3f1c2d4-..."​# Seed for reproducible datafake = Tina4::FakeData.new(seed: 42)