Initial website.

Author: ioquatix

.github/workflows/documentation.yaml

@@ -0,0 +1,54 @@
+name: Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+env:
+  BUNDLE_WITH: maintenance
+
+jobs:
+  generate:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ruby
+          bundler-cache: true
+
+      - name: Generate static site
+        timeout-minutes: 5
+        run: bundle exec rackula generate --config config.ru --public public --output-path tmp/static --force
+
+      - name: Upload documentation artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: tmp/static
+
+  deploy:
+    runs-on: ubuntu-latest
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    needs: generate
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,14 @@
+# Development specific:
+/.bundle
+
+# Temporary data should not be added to the repository:
+/tmp
+
+# Node modules are 3rd party dependencies which can be fetched easily:
+/node_modules
+
+# This file should only ever exist on production, and may contain sensitive information:
+/config/environment.yaml
+
+# Ignore resized gallery photos:
+/public/_gallery

Guardfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+group :development do
+	guard :falcon, port: 9292 do
+		watch("Gemfile.lock")
+		watch("gems.locked")
+		watch("config.ru")
+		watch(%r{^config|lib|pages/.*})
+		
+		notification :off
+	end
+end

bake.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2020-2025, by Samuel Williams.
+
+def deploy
+	# This task is typiclly run after the site is updated but before the server is restarted.
+end
+
+# Restart the application server.
+def restart
+	call "falcon:supervisor:restart"
+end
+
+# Start the development server.
+def default
+	call "utopia:development"
+end

config.ru

@@ -0,0 +1,49 @@
+#!/usr/bin/env rackup
+# frozen_string_literal: true
+
+require_relative "config/environment"
+
+self.freeze_app
+
+if UTOPIA.production?
+	# Handle exceptions in production with a error page and send an email notification:
+	use Utopia::Exceptions::Handler
+	use Utopia::Exceptions::Mailer
+else
+	# We want to propate exceptions up when running tests:
+	use Rack::ShowExceptions unless UTOPIA.testing?
+end
+
+# Serve static files from "public" directory:
+use Utopia::Static, root: "public"
+
+use Utopia::Redirection::Rewrite, {
+	"/" => "/welcome/index"
+}
+
+use Utopia::Redirection::DirectoryIndex
+
+use Utopia::Redirection::Errors, {
+	404 => "/errors/file-not-found"
+}
+
+require "utopia/localization"
+use Utopia::Localization,
+	default_locale: "en",
+	locales: ["en", "de", "ja", "zh"]
+
+require "utopia/session"
+use Utopia::Session,
+	expires_after: 3600 * 24,
+	secret: UTOPIA.secret_for(:session),
+	secure: true
+
+use Utopia::Controller
+
+# Serve static files from "pages" directory:
+use Utopia::Static
+
+# Serve dynamic content:
+use Utopia::Content
+
+run lambda {|env| [404, {}, []]}

config/development.yaml

@@ -0,0 +1,2 @@
+---
+UTOPIA_SESSION_SECRET: adc5aafc7cc348b07e3fbb4a1678b21ee9ad5268946fc64ee7734c0736ac8c7d5b045a3f76fec875

config/environment.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2016-2025, by Samuel Williams.
+
+require "bundler/setup"
+Bundler.setup
+
+require "utopia/setup"
+UTOPIA ||= Utopia.setup

config/readme.md

@@ -0,0 +1,7 @@
+# Utopia Config
+
+This directory contains `environment.rb` which is used to initialize the running environment for tasks and servers.
+
+## Setting Environment Variables
+
+If you wish to set environment variables on a per-deployment basis, you can do so by creating an `config/environment.yaml` and populating it with key-value pairs.

config/sus.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2017-2025, by Samuel Williams.
+
+require "variant"
+Variant.force!(:testing)
+
+require "covered/sus"
+include Covered::Sus

config/testing.yaml

@@ -0,0 +1,2 @@
+---
+UTOPIA_SESSION_SECRET: dccce67d45e0fa37271d859bd2f9d29546eb7f658698524b9f15bc799d0e8b5b07ad17c36e7261e0