smart_domain 0.1.0

data/examples/blog_app/db/schema.rb

@@ -0,0 +1,46 @@
+# This file is auto-generated from the current state of the database. Instead
+# of editing this file, please use the migrations feature of Active Record to
+# incrementally modify your database, and then regenerate this schema definition.
+#
+# This file is the source Rails uses to define your schema when running `bin/rails
+# db:schema:load`. When creating a new database, `bin/rails db:schema:load` tends to
+# be faster and is potentially less error prone than running all of your
+# migrations from scratch. Old migrations may fail to apply correctly if those
+# migrations use external dependencies or application code.
+#
+# It's strongly recommended that you check this file into your version control system.
+
+ActiveRecord::Schema[8.1].define(version: 2025_12_30_112504) do
+  create_table "organizations", force: :cascade do |t|
+    t.datetime "created_at", null: false
+    t.string "name"
+    t.datetime "updated_at", null: false
+  end
+
+  create_table "posts", force: :cascade do |t|
+    t.text "body"
+    t.datetime "created_at", null: false
+    t.integer "organization_id", null: false
+    t.boolean "published"
+    t.datetime "published_at"
+    t.string "title"
+    t.datetime "updated_at", null: false
+    t.integer "user_id", null: false
+    t.index ["organization_id"], name: "index_posts_on_organization_id"
+    t.index ["user_id"], name: "index_posts_on_user_id"
+  end
+
+  create_table "users", force: :cascade do |t|
+    t.datetime "created_at", null: false
+    t.string "email"
+    t.string "name"
+    t.integer "organization_id", null: false
+    t.string "role"
+    t.datetime "updated_at", null: false
+    t.index ["organization_id"], name: "index_users_on_organization_id"
+  end
+
+  add_foreign_key "posts", "organizations"
+  add_foreign_key "posts", "users"
+  add_foreign_key "users", "organizations"
+end

data/examples/blog_app/db/seeds.rb

@@ -0,0 +1,9 @@
+# This file should ensure the existence of records required to run the application in every environment (production,
+# development, test). The code here should be idempotent so that it can be executed at any point in every environment.
+# The data can then be loaded with the bin/rails db:seed command (or created alongside the database with db:setup).
+#
+# Example:
+#
+#   ["Action", "Comedy", "Drama", "Horror"].each do |genre_name|
+#     MovieGenre.find_or_create_by!(name: genre_name)
+#   end

data/examples/blog_app/lib/api_demo.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+# API Demo script showing controller → service → events flow
+#
+# Run with: rails runner lib/api_demo.rb
+
+puts "\n" + "=" * 80
+puts "SmartDomain API Demo - Controller → Service → Events"
+puts "=" * 80 + "\n\n"
+
+# Clean up
+Organization.destroy_all
+puts "Cleaned up existing data\n\n"
+
+# Create organization
+org = Organization.create!(name: "API Demo Corp")
+puts "Step 1: Created organization: #{org.name}"
+puts "  - ID: #{org.id}\n\n"
+
+# Simulate API request context
+module ApiContext
+  class << self
+    attr_accessor :current_organization, :current_user
+  end
+end
+
+ApiContext.current_organization = org
+
+# Create admin user
+admin = org.users.create!(
+  email: "admin@apidemo.com",
+  name: "API Admin",
+  role: "admin"
+)
+
+ApiContext.current_user = admin
+puts "Step 2: Created admin user: #{admin.name} <#{admin.email}>\n\n"
+
+# Simulate UsersController#create
+puts "Step 3: Simulating POST /api/v1/users (UsersController#create)"
+puts "  - Controller receives request"
+puts "  - Controller delegates to UserManagement::UserService"
+
+SmartDomain::Integration::TenantContext.with_tenant(org.id) do
+  service = UserManagement::UserService.new(
+    current_user: admin,
+    organization_id: org.id
+  )
+
+  user = service.create_user(
+    email: "john@apidemo.com",
+    name: "John Doe",
+    role: "editor"
+  )
+
+  puts "  - Service created user: #{user.name}"
+  puts "  - Service published UserCreatedEvent"
+  puts "  - Handlers triggered: AuditHandler, MetricsHandler, UserWelcomeHandler"
+  puts "  - Controller returns JSON response\n\n"
+
+  # Simulate PostsController#create
+  puts "Step 4: Simulating POST /api/v1/posts (PostsController#create)"
+  puts "  - Controller receives request"
+  puts "  - Controller delegates to PostManagement::PostService"
+
+  post_service = PostManagement::PostService.new(
+    current_user: user,
+    organization_id: org.id
+  )
+
+  post = post_service.create_post(
+    title: "My First API Post",
+    body: "This post was created via the API!",
+    user_id: user.id,
+    organization_id: org.id,
+    published: false
+  )
+
+  puts "  - Service created post: #{post.title}"
+  puts "  - Service published PostCreatedEvent"
+  puts "  - Handlers triggered: AuditHandler, MetricsHandler"
+  puts "  - Controller returns JSON response\n\n"
+
+  # Simulate PostsController#publish
+  puts "Step 5: Simulating POST /api/v1/posts/#{post.id}/publish"
+  puts "  - Controller receives request"
+  puts "  - Controller checks authorization (PostPolicy)"
+  puts "  - Controller calls post.publish!"
+
+  old_published = post.published
+  old_published_at = post.published_at
+  post.publish!
+
+  # Manually publish event (as controller would)
+  event = PostUpdatedEvent.new(
+    event_type: "post.updated",
+    aggregate_id: post.id.to_s,
+    aggregate_type: "Post",
+    organization_id: org.id.to_s,
+    actor_id: user.id.to_s,
+    actor_email: user.email,
+    post_id: post.id.to_s,
+    changed_fields: ["published", "published_at"],
+    old_values: { "published" => old_published, "published_at" => old_published_at },
+    new_values: { "published" => true, "published_at" => post.published_at.iso8601 }
+  )
+
+  SmartDomain::Event.bus.publish(event)
+
+  puts "  - Controller published PostUpdatedEvent with change tracking"
+  puts "  - Changed fields: published, published_at"
+  puts "  - Handlers triggered: AuditHandler, MetricsHandler, PostNotificationHandler"
+  puts "  - Controller returns JSON response\n\n"
+
+  # Simulate GET /api/v1/posts (index)
+  puts "Step 6: Simulating GET /api/v1/posts (PostsController#index)"
+  puts "  - Controller receives request"
+  puts "  - Controller queries with TenantContext.with_tenant"
+
+  posts = Post.all
+  puts "  - Found #{posts.count} post(s) in organization #{org.name}"
+  posts.each do |p|
+    puts "    * #{p.title} (#{p.published? ? 'Published' : 'Draft'})"
+  end
+  puts "  - Controller returns JSON response\n\n"
+
+  # Simulate authorization failure
+  puts "Step 7: Demonstrating authorization with policies"
+
+  # Create viewer user
+  viewer = org.users.create!(
+    email: "viewer@apidemo.com",
+    name: "Viewer User",
+    role: "viewer"
+  )
+
+  admin_policy = PostPolicy.new(admin, post)
+  viewer_policy = PostPolicy.new(viewer, post)
+
+  puts "  - Admin attempts to delete post:"
+  puts "    PostPolicy.new(admin, post).destroy? => #{admin_policy.destroy?}"
+
+  puts "  - Viewer attempts to delete post:"
+  puts "    PostPolicy.new(viewer, post).destroy? => #{viewer_policy.destroy?}"
+  puts "    → Would raise SmartDomain::Domain::Exceptions::UnauthorizedError"
+  puts "    → Controller catches and returns 403 Forbidden\n\n"
+end
+
+puts "=" * 80
+puts "API Demo Summary"
+puts "=" * 80
+puts "\nComplete request flow demonstrated:"
+puts "1. ✓ HTTP Request → Controller (Interface Layer)"
+puts "2. ✓ Controller → Domain Service (Business Logic Layer)"
+puts "3. ✓ Service → Model + Events (Domain Layer)"
+puts "4. ✓ Events → Handlers (Side Effects Layer)"
+puts "5. ✓ Controller ← JSON Response"
+puts "\nKey patterns:"
+puts "- Controllers are thin adapters (interface layer)"
+puts "- Domain logic lives in services (framework-agnostic)"
+puts "- Events published automatically or manually"
+puts "- Policies enforce authorization"
+puts "- Multi-tenancy ensures data isolation"
+puts "\nAPI Endpoints available:"
+puts "- GET    /api/v1/users"
+puts "- POST   /api/v1/users"
+puts "- PATCH  /api/v1/users/:id"
+puts "- DELETE /api/v1/users/:id"
+puts "- GET    /api/v1/posts"
+puts "- POST   /api/v1/posts"
+puts "- PATCH  /api/v1/posts/:id"
+puts "- DELETE /api/v1/posts/:id"
+puts "- POST   /api/v1/posts/:id/publish"
+puts "- POST   /api/v1/posts/:id/unpublish"
+puts "=" * 80 + "\n\n"

data/examples/blog_app/lib/demo.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+# Demo script showing SmartDomain features
+#
+# Run with: rails runner lib/demo.rb
+
+puts "\n" + "=" * 80
+puts "SmartDomain Gem - Feature Demonstration"
+puts "=" * 80 + "\n\n"
+
+# Clean up any existing data
+Organization.destroy_all
+puts "Cleaned up existing data\n\n"
+
+# Step 1: Create an organization (multi-tenancy)
+puts "Step 1: Creating organization (multi-tenancy setup)..."
+org = Organization.create!(name: "Acme Corp")
+puts "✓ Created organization: #{org.name} (ID: #{org.id})\n\n"
+
+# Step 2: Create a user using the domain service
+puts "Step 2: Creating user via UserService (demonstrates domain service + events)..."
+SmartDomain::Integration::TenantContext.with_tenant(org.id) do
+  service = UserManagement::UserService.new(
+    current_user: nil,
+    organization_id: org.id
+  )
+
+  user_attributes = {
+    email: "john@acme.com",
+    name: "John Doe",
+    role: "admin",
+    organization_id: org.id
+  }
+
+  user = service.create_user(user_attributes)
+  puts "✓ Created user: #{user.name} <#{user.email}>"
+  puts "  - Role: #{user.role}"
+  puts "  - Organization: #{org.name}"
+  puts "  - Events published: user.created"
+  puts "  - Handlers triggered: AuditHandler, MetricsHandler, UserWelcomeHandler"
+  puts "\n"
+
+  # Step 3: Create a post
+  puts "Step 3: Creating a blog post..."
+  post_service = PostManagement::PostService.new(
+    current_user: user,
+    organization_id: org.id
+  )
+
+  post = post_service.create_post({
+    title: "Getting Started with SmartDomain",
+    body: "SmartDomain brings DDD and EDA patterns to Rails...",
+    user_id: user.id,
+    organization_id: org.id,
+    published: false
+  })
+
+  puts "✓ Created post: #{post.title}"
+  puts "  - Author: #{post.user.name}"
+  puts "  - Status: Draft"
+  puts "  - Events published: post.created"
+  puts "\n"
+
+  # Step 4: Publish the post (triggers update event)
+  puts "Step 4: Publishing the post (demonstrates change tracking)..."
+  post.publish!
+
+  # Create event with change tracking
+  event = PostUpdatedEvent.new(
+    event_type: "post.updated",
+    aggregate_id: post.id.to_s,
+    aggregate_type: "Post",
+    organization_id: org.id.to_s,
+    actor_id: user.id.to_s,
+    actor_email: user.email,
+    post_id: post.id.to_s,
+    changed_fields: ["published", "published_at"],
+    old_values: { "published" => false, "published_at" => nil },
+    new_values: { "published" => true, "published_at" => post.published_at.iso8601 }
+  )
+
+  SmartDomain::Event.bus.publish(event)
+
+  puts "✓ Published post: #{post.title}"
+  puts "  - Published at: #{post.published_at}"
+  puts "  - Events published: post.updated"
+  puts "  - Changed fields: published, published_at"
+  puts "  - Handlers triggered: AuditHandler, MetricsHandler, PostNotificationHandler"
+  puts "\n"
+
+  # Step 5: Demonstrate authorization with policies
+  puts "Step 5: Demonstrating authorization policies..."
+
+  # Create a viewer user
+  viewer = User.create!(
+    email: "jane@acme.com",
+    name: "Jane Smith",
+    role: "viewer",
+    organization_id: org.id
+  )
+
+  admin_policy = PostPolicy.new(user, post)
+  viewer_policy = PostPolicy.new(viewer, post)
+
+  puts "✓ Authorization checks:"
+  puts "  - Admin can update post: #{admin_policy.update?}"
+  puts "  - Admin can destroy post: #{admin_policy.destroy?}"
+  puts "  - Viewer can view post: #{viewer_policy.show?}"
+  puts "  - Viewer can update post: #{viewer_policy.update?}"
+  puts "  - Viewer can destroy post: #{viewer_policy.destroy?}"
+  puts "\n"
+
+  # Step 6: Multi-tenancy isolation
+  puts "Step 6: Demonstrating multi-tenancy isolation..."
+  other_org = Organization.create!(name: "Other Corp")
+
+  SmartDomain::Integration::TenantContext.with_tenant(other_org.id) do
+    other_user = User.create!(
+      email: "bob@other.com",
+      name: "Bob Johnson",
+      role: "admin",
+      organization_id: other_org.id
+    )
+
+    puts "✓ Created second organization: #{other_org.name}"
+    puts "  - Users in Acme Corp: #{org.users.count}"
+    puts "  - Users in Other Corp: #{other_org.users.count}"
+    puts "  - Posts in Acme Corp: #{org.posts.count}"
+    puts "  - Posts in Other Corp: #{other_org.posts.count}"
+    puts "  - Data is properly isolated by organization_id"
+  end
+  puts "\n"
+end
+
+# Summary
+puts "=" * 80
+puts "Demo Summary"
+puts "=" * 80
+puts "\nFeatures demonstrated:"
+puts "1. ✓ Multi-tenancy with TenantContext"
+puts "2. ✓ Domain services for business logic"
+puts "3. ✓ Event-driven architecture with domain events"
+puts "4. ✓ Generic handlers (70% boilerplate reduction)"
+puts "5. ✓ Custom event handlers"
+puts "6. ✓ Event mixins (Actor, ChangeTracking)"
+puts "7. ✓ Domain policies for authorization"
+puts "8. ✓ ActiveRecord integration"
+puts "9. ✓ Organization-based data isolation"
+puts "\nCheck your Rails logs to see all the events and handler executions!"
+puts "=" * 80 + "\n\n"

data/examples/blog_app/public/400.html

@@ -0,0 +1,135 @@
+<!doctype html>
+
+<html lang="en">
+
+  <head>
+
+    <title>The server cannot process the request due to a client error (400 Bad Request)</title>
+
+    <meta charset="utf-8">
+    <meta name="viewport" content="initial-scale=1, width=device-width">
+    <meta name="robots" content="noindex, nofollow">
+
+    <style>
+
+      *, *::before, *::after {
+        box-sizing: border-box;
+      }
+
+      * {
+        margin: 0;
+      }
+
+      html {
+        font-size: 16px;
+      }
+
+      body {
+        background: #FFF;
+        color: #261B23;
+        display: grid;
+        font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, Aptos, Roboto, "Segoe UI", "Helvetica Neue", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+        font-size: clamp(1rem, 2.5vw, 2rem);
+        -webkit-font-smoothing: antialiased;
+        font-style: normal;
+        font-weight: 400;
+        letter-spacing: -0.0025em;
+        line-height: 1.4;
+        min-height: 100dvh;
+        place-items: center;
+        text-rendering: optimizeLegibility;
+        -webkit-text-size-adjust: 100%;
+      }
+
+      #error-description {
+        fill: #d30001;
+      }
+
+      #error-id {
+        fill: #f0eff0;
+      }
+
+      @media (prefers-color-scheme: dark) {
+        body {
+          background: #101010;
+          color: #e0e0e0;
+        }
+
+        #error-description {
+          fill: #FF6161;
+        }
+
+        #error-id {
+          fill: #2c2c2c;
+        }
+      }
+
+      a {
+        color: inherit;
+        font-weight: 700;
+        text-decoration: underline;
+        text-underline-offset: 0.0925em;
+      }
+
+      b, strong {
+        font-weight: 700;
+      }
+
+      i, em {
+        font-style: italic;
+      }
+
+      main {
+        display: grid;
+        gap: 1em;
+        padding: 2em;
+        place-items: center;
+        text-align: center;
+      }
+
+      main header {
+        width: min(100%, 12em);
+      }
+
+      main header svg {
+        height: auto;
+        max-width: 100%;
+        width: 100%;
+      }
+
+      main article {
+        width: min(100%, 30em);
+      }
+
+      main article p {
+        font-size: 75%;
+      }
+
+      main article br {
+        display: none;
+
+        @media(min-width: 48em) {
+          display: inline;
+        }
+      }
+
+    </style>
+
+  </head>
+
+  <body>
+
+    <!-- This file lives in public/400.html -->
+
+    <main>
+      <header>
+        <svg height="172" viewBox="0 0 480 172" width="480" xmlns="http://www.w3.org/2000/svg"><path d="m124.48 3.00509-45.6889 100.02991h26.2239v-28.1168h38.119v28.1168h21.628v35.145h-21.628v30.82h-37.308v-30.82h-72.1833v-31.901l50.2851-103.27391zm115.583 168.69891c-40.822 0-64.884-35.146-64.884-85.7015 0-50.5554 24.062-85.700907 64.884-85.700907 40.823 0 64.884 35.145507 64.884 85.700907 0 50.5555-24.061 85.7015-64.884 85.7015zm0-133.2831c-17.572 0-22.709 21.8984-22.709 47.5816 0 25.6835 5.137 47.5815 22.709 47.5815 17.303 0 22.71-21.898 22.71-47.5815 0-25.6832-5.407-47.5816-22.71-47.5816zm140.456 133.2831c-40.823 0-64.884-35.146-64.884-85.7015 0-50.5554 24.061-85.700907 64.884-85.700907 40.822 0 64.884 35.145507 64.884 85.700907 0 50.5555-24.062 85.7015-64.884 85.7015zm0-133.2831c-17.573 0-22.71 21.8984-22.71 47.5816 0 25.6835 5.137 47.5815 22.71 47.5815 17.302 0 22.709-21.898 22.709-47.5815 0-25.6832-5.407-47.5816-22.709-47.5816z" id="error-id"/><path d="m123.606 85.4445c3.212 1.0523 5.538 4.2089 5.538 8.0301 0 6.1472-4.209 9.5254-11.298 9.5254h-15.617v-34.0033h14.565c7.089 0 11.353 3.1566 11.353 9.2484 0 3.6551-2.049 6.3134-4.541 7.1994zm-12.904-2.9905h5.095c2.603 0 3.988-.9968 3.988-3.1013 0-2.1044-1.385-3.0459-3.988-3.0459h-5.095zm0 6.6456v6.5902h5.981c2.492 0 3.877-1.3291 3.877-3.2674 0-2.049-1.385-3.3228-3.877-3.3228zm43.786 13.9004h-8.362v-1.274c-.831.831-3.323 1.717-5.981 1.717-4.929 0-9.083-2.769-9.083-8.0301 0-4.818 4.154-7.9193 9.581-7.9193 2.049 0 4.486.6646 5.483 1.3845v-1.606c0-1.606-.942-2.9905-3.046-2.9905-1.606 0-2.548.7199-2.935 1.8275h-8.197c.72-4.8181 4.985-8.6393 11.409-8.6393 7.088 0 11.131 3.7659 11.131 10.2453zm-8.362-6.9779v-1.4399c-.554-1.0522-2.049-1.7167-3.655-1.7167-1.717 0-3.434.7199-3.434 2.3813 0 1.7168 1.717 2.4367 3.434 2.4367 1.606 0 3.101-.6645 3.655-1.6614zm27.996 6.9779v-1.994c-1.163 1.329-3.599 2.548-6.147 2.548-7.199 0-11.131-5.8151-11.131-13.0145s3.932-13.0143 11.131-13.0143c2.548 0 4.984 1.2184 6.147 2.5475v-13.0697h8.695v35.997zm0-9.1931v-6.5902c-.664-1.3291-2.159-2.326-3.821-2.326-2.99 0-4.763 2.4368-4.763 5.6488s1.773 5.5934 4.763 5.5934c1.717 0 3.157-.9415 3.821-2.326zm35.471-2.049h-3.101v11.2421h-8.806v-34.0033h15.285c7.31 0 12.35 4.1535 12.35 11.5744 0 5.1503-2.603 8.6947-6.757 10.2453l7.975 12.1836h-9.858zm-3.101-15.2849v8.1962h5.538c3.156 0 4.596-1.606 4.596-4.0981s-1.44-4.0981-4.596-4.0981zm36.957 17.8323h8.03c-.886 5.7597-5.206 9.2487-11.685 9.2487-7.643 0-12.682-5.2613-12.682-13.0145 0-7.6978 5.316-13.0143 12.515-13.0143 7.643 0 11.962 5.095 11.962 12.5159v2.1598h-16.115c.277 2.9905 1.827 4.5965 4.32 4.5965 1.772 0 3.156-.7753 3.655-2.4921zm-3.822-10.0237c-2.049 0-3.433 1.2737-3.987 3.5997h7.532c-.111-2.0491-1.385-3.5997-3.545-3.5997zm30.98 27.5234v-10.799c-1.163 1.329-3.6 2.548-6.147 2.548-7.2 0-11.132-5.9259-11.132-13.0145 0-7.144 3.932-13.0143 11.132-13.0143 2.547 0 4.984 1.2184 6.147 2.5475v-1.9937h8.695v33.726zm0-17.9981v-6.5902c-.665-1.3291-2.105-2.326-3.821-2.326-2.991 0-4.763 2.4368-4.763 5.6488s1.772 5.5934 4.763 5.5934c1.661 0 3.156-.9415 3.821-2.326zm36.789-15.7279v24.921h-8.695v-2.16c-1.329 1.551-3.821 2.714-6.646 2.714-5.482 0-8.75-3.5999-8.75-9.1379v-16.3371h8.64v14.288c0 2.1045.996 3.5997 3.212 3.5997 1.606 0 3.101-1.0522 3.544-2.769v-15.1187zm19.084 16.2263h8.03c-.886 5.7597-5.206 9.2487-11.685 9.2487-7.643 0-12.682-5.2613-12.682-13.0145 0-7.6978 5.316-13.0143 12.515-13.0143 7.643 0 11.963 5.095 11.963 12.5159v2.1598h-16.116c.277 2.9905 1.828 4.5965 4.32 4.5965 1.772 0 3.156-.7753 3.655-2.4921zm-3.822-10.0237c-2.049 0-3.433 1.2737-3.987 3.5997h7.532c-.111-2.0491-1.385-3.5997-3.545-3.5997zm13.428 11.0206h8.474c.387 1.3845 1.606 2.1598 3.156 2.1598 1.44 0 2.548-.5538 2.548-1.7168 0-.9414-.72-1.2737-1.939-1.5506l-4.873-.9969c-4.154-.886-6.867-2.8797-6.867-7.2547 0-5.3165 4.762-8.4178 10.633-8.4178 6.812 0 10.522 3.1567 11.297 8.0855h-8.03c-.277-1.0522-1.052-1.9937-3.046-1.9937-1.273 0-2.326.5538-2.326 1.6614 0 .7753.554 1.163 1.717 1.3845l4.929 1.163c4.541 1.0522 6.978 3.4335 6.978 7.4763 0 5.3168-4.818 8.2518-10.91 8.2518-6.369 0-10.965-2.88-11.741-8.2518zm27.538-.8861v-9.5807h-3.655v-6.7564h3.655v-6.8671h8.584v6.8671h5.205v6.7564h-5.205v8.307c0 1.9383.941 2.769 2.658 2.769.941 0 1.993-.2216 2.769-.5538v7.3654c-.997.443-2.88.775-4.818.775-5.871 0-9.193-2.769-9.193-9.0819z" id="error-description"/></svg>
+      </header>
+      <article>
+        <p><strong>The server cannot process the request due to a client error.</strong> Please check the request and try again. If you're the application owner check the logs for more information.</p>
+      </article>
+    </main>
+
+  </body>
+
+</html>

data/examples/blog_app/public/404.html

@@ -0,0 +1,135 @@
+<!doctype html>
+
+<html lang="en">
+
+  <head>
+
+    <title>The page you were looking for doesn't exist (404 Not found)</title>
+
+    <meta charset="utf-8">
+    <meta name="viewport" content="initial-scale=1, width=device-width">
+    <meta name="robots" content="noindex, nofollow">
+
+    <style>
+
+      *, *::before, *::after {
+        box-sizing: border-box;
+      }
+
+      * {
+        margin: 0;
+      }
+
+      html {
+        font-size: 16px;
+      }
+
+      body {
+        background: #FFF;
+        color: #261B23;
+        display: grid;
+        font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, Aptos, Roboto, "Segoe UI", "Helvetica Neue", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+        font-size: clamp(1rem, 2.5vw, 2rem);
+        -webkit-font-smoothing: antialiased;
+        font-style: normal;
+        font-weight: 400;
+        letter-spacing: -0.0025em;
+        line-height: 1.4;
+        min-height: 100dvh;
+        place-items: center;
+        text-rendering: optimizeLegibility;
+        -webkit-text-size-adjust: 100%;
+      }
+
+      #error-description {
+        fill: #d30001;
+      }
+
+      #error-id {
+        fill: #f0eff0;
+      }
+
+      @media (prefers-color-scheme: dark) {
+        body {
+          background: #101010;
+          color: #e0e0e0;
+        }
+
+        #error-description {
+          fill: #FF6161;
+        }
+
+        #error-id {
+          fill: #2c2c2c;
+        }
+      }
+
+      a {
+        color: inherit;
+        font-weight: 700;
+        text-decoration: underline;
+        text-underline-offset: 0.0925em;
+      }
+
+      b, strong {
+        font-weight: 700;
+      }
+
+      i, em {
+        font-style: italic;
+      }
+
+      main {
+        display: grid;
+        gap: 1em;
+        padding: 2em;
+        place-items: center;
+        text-align: center;
+      }
+
+      main header {
+        width: min(100%, 12em);
+      }
+
+      main header svg {
+        height: auto;
+        max-width: 100%;
+        width: 100%;
+      }
+
+      main article {
+        width: min(100%, 30em);
+      }
+
+      main article p {
+        font-size: 75%;
+      }
+
+      main article br {
+        display: none;
+
+        @media(min-width: 48em) {
+          display: inline;
+        }
+      }
+
+    </style>
+
+  </head>
+
+  <body>
+
+    <!-- This file lives in public/404.html -->
+
+    <main>
+      <header>
+        <svg height="172" viewBox="0 0 480 172" width="480" xmlns="http://www.w3.org/2000/svg"><path d="m124.48 3.00509-45.6889 100.02991h26.2239v-28.1168h38.119v28.1168h21.628v35.145h-21.628v30.82h-37.308v-30.82h-72.1833v-31.901l50.2851-103.27391zm115.583 168.69891c-40.822 0-64.884-35.146-64.884-85.7015 0-50.5554 24.062-85.700907 64.884-85.700907 40.823 0 64.884 35.145507 64.884 85.700907 0 50.5555-24.061 85.7015-64.884 85.7015zm0-133.2831c-17.572 0-22.709 21.8984-22.709 47.5816 0 25.6835 5.137 47.5815 22.709 47.5815 17.303 0 22.71-21.898 22.71-47.5815 0-25.6832-5.407-47.5816-22.71-47.5816zm165.328-35.41581-45.689 100.02991h26.224v-28.1168h38.119v28.1168h21.628v35.145h-21.628v30.82h-37.308v-30.82h-72.184v-31.901l50.285-103.27391z" id="error-id"/><path d="m157.758 68.9967v34.0033h-7.199l-14.233-19.8814v19.8814h-8.584v-34.0033h8.307l13.125 18.7184v-18.7184zm28.454 21.5428c0 7.6978-5.15 13.0145-12.737 13.0145-7.532 0-12.738-5.3167-12.738-13.0145s5.206-13.0143 12.738-13.0143c7.587 0 12.737 5.3165 12.737 13.0143zm-8.528 0c0-3.4336-1.496-5.8703-4.209-5.8703-2.659 0-4.154 2.4367-4.154 5.8703s1.495 5.8149 4.154 5.8149c2.713 0 4.209-2.3813 4.209-5.8149zm13.184 3.8766v-9.5807h-3.655v-6.7564h3.655v-6.8671h8.584v6.8671h5.205v6.7564h-5.205v8.307c0 1.9383.941 2.769 2.658 2.769.941 0 1.994-.2216 2.769-.5538v7.3654c-.997.443-2.88.775-4.818.775-5.87 0-9.193-2.769-9.193-9.0819zm37.027 8.5839h-8.806v-34.0033h23.924v7.6978h-15.118v6.7564h13.9v7.5316h-13.9zm41.876-12.4605c0 7.6978-5.15 13.0145-12.737 13.0145-7.532 0-12.738-5.3167-12.738-13.0145s5.206-13.0143 12.738-13.0143c7.587 0 12.737 5.3165 12.737 13.0143zm-8.529 0c0-3.4336-1.495-5.8703-4.208-5.8703-2.659 0-4.154 2.4367-4.154 5.8703s1.495 5.8149 4.154 5.8149c2.713 0 4.208-2.3813 4.208-5.8149zm35.337-12.4605v24.921h-8.695v-2.16c-1.329 1.551-3.821 2.714-6.646 2.714-5.482 0-8.75-3.5999-8.75-9.1379v-16.3371h8.64v14.288c0 2.1045.997 3.5997 3.212 3.5997 1.606 0 3.101-1.0522 3.544-2.769v-15.1187zm4.076 24.921v-24.921h8.694v2.1598c1.385-1.5506 3.822-2.7136 6.701-2.7136 5.538 0 8.806 3.5997 8.806 9.1377v16.3371h-8.639v-14.2327c0-2.049-1.053-3.5443-3.268-3.5443-1.717 0-3.156.9969-3.6 2.7136v15.0634zm44.113 0v-1.994c-1.163 1.329-3.6 2.548-6.147 2.548-7.2 0-11.132-5.8151-11.132-13.0145s3.932-13.0143 11.132-13.0143c2.547 0 4.984 1.2184 6.147 2.5475v-13.0697h8.695v35.997zm0-9.1931v-6.5902c-.665-1.3291-2.16-2.326-3.821-2.326-2.991 0-4.763 2.4368-4.763 5.6488s1.772 5.5934 4.763 5.5934c1.717 0 3.156-.9415 3.821-2.326z" id="error-description"/></svg>
+      </header>
+      <article>
+        <p><strong>The page you were looking for doesn't exist.</strong> You may have mistyped the address or the page may have moved. If you're the application owner check the logs for more information.</p>
+      </article>
+    </main>
+
+  </body>
+
+</html>