opt.

Author: lollipopkit

Makefile

@@ -10,6 +10,7 @@ PLATFORM ?=
 ENV_FILE ?=
 XCARCHIVE_PATH ?=
 APP_PATH ?=
+DMG_PATH ?=
 TAP_REPO_PATH ?=
 
 .PHONY: help deps pub-get run run-device analyze test test-one coverage \
@@ -51,10 +52,10 @@ help:
 		'  package-dmg        Run scripts/release/package-dmg-from-xcarchive.sh' \
 		'                     Example: make package-dmg APP_PATH="/path/Server Box.app"' \
 		'                     Example: make package-dmg XCARCHIVE_PATH=/path/Runner.xcarchive' \
-		'  sync-homebrew-cask Generate ~/proj/homebrew-taps/Casks/serverbox.rb from a built DMG' \
+		'  sync-homebrew-cask Generate ~/proj/homebrew-taps/Casks/server-box.rb from a built DMG' \
 		'                     Example: make sync-homebrew-cask APP_PATH="/path/Server Box.app"' \
 		'                     Example: make sync-homebrew-cask XCARCHIVE_PATH=/path/Runner.xcarchive' \
-		'                     Example: make sync-homebrew-cask DMG_PATH=build/artifacts/ServerBox-1.0.1365.dmg'
+		'                     Example: make sync-homebrew-cask DMG_PATH=build/artifacts/ServerBox-1.0.1.dmg'
 
 deps pub-get:
 	$(FLUTTER) pub get
@@ -146,7 +147,7 @@ sync-homebrew-cask:
 		echo 'APP_PATH, XCARCHIVE_PATH, or DMG_PATH is required.'; \
 		echo 'Example: make sync-homebrew-cask APP_PATH="/path/Server Box.app"'; \
 		echo 'Example: make sync-homebrew-cask XCARCHIVE_PATH=/path/Runner.xcarchive'; \
-		echo 'Example: make sync-homebrew-cask DMG_PATH=build/artifacts/ServerBox-1.0.1365.dmg'; \
+		echo 'Example: make sync-homebrew-cask DMG_PATH=build/artifacts/ServerBox-1.0.1.dmg'; \
 		exit 1; \
 	fi
 	@if [ -n "$(APP_PATH)" ]; then \

docs/astro.config.mjs

@@ -4,6 +4,7 @@ import starlight from '@astrojs/starlight';
 
 // https://astro.build/config
 export default defineConfig({
+	base: '/docs',
 	integrations: [
 		starlight({
 			title: 'Server Box',

scripts/build-cloudflare-pages.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+cd "$ROOT_DIR/website"
+bun install --frozen-lockfile
+bun run build
+
+cd "$ROOT_DIR/docs"
+bun install
+bun run build
+
+rm -rf "$ROOT_DIR/website/dist/docs"
+mkdir -p "$ROOT_DIR/website/dist/docs"
+cp -R "$ROOT_DIR/docs/dist/." "$ROOT_DIR/website/dist/docs/"

scripts/release/release-macos-dmg.sh

@@ -395,5 +395,5 @@ if [[ "$PUBLISH_GITHUB_RELEASE" == "1" ]]; then
   echo "GitHub release: $APP_REPO_SLUG $RELEASE_TAG"
 fi
 if [[ "${SYNC_HOMEBREW_CASK:-1}" == "1" ]]; then
-  echo "Homebrew cask: ${TAP_REPO_PATH:-$HOME/proj/homebrew-taps}/Casks/serverbox.rb"
+  echo "Homebrew cask: ${TAP_REPO_PATH:-$HOME/proj/homebrew-taps}/Casks/server-box.rb"
 fi

scripts/release/sync-homebrew-cask.sh

@@ -4,7 +4,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
 APP_NAME="${APP_NAME:-Server Box}"
-CASK_NAME="${CASK_NAME:-serverbox}"
+CASK_NAME="${CASK_NAME:-server-box}"
 CASK_DISPLAY_NAME="${CASK_DISPLAY_NAME:-ServerBox}"
 CASK_DESC="${CASK_DESC:-App for monitoring server status with SSH terminal, SFTP, Container management}"
 APP_REPO_SLUG="${APP_REPO_SLUG:-lollipopkit/flutter_server_box}"

website/jsconfig.json

@@ -34,5 +34,5 @@
    * Use global.d.ts instead of compilerOptions.types
    * to avoid limiting type declarations.
    */
-  "include": ["src/**/*.d.ts", "src/**/*.js", "src/**/*.svelte"]
+  "include": ["src/**/*.d.ts", "src/**/*.js", "src/**/*.svelte", "src/**/*.ts"]
 }

website/src/App.svelte

@@ -89,8 +89,8 @@
   }
 
   let locale = $state(initialLocale)
-  let isMounted = $state(false)
   let copiedCommand = $state(undefined)
+  let copyFallbackCommand = $state(undefined)
 
   function applyLocale(nextLocale) {
     locale = nextLocale
@@ -103,12 +103,10 @@
     const nextLocale = locale || getInitialLocale()
     applyLocale(nextLocale)
     syncLocaleToUrl(nextLocale)
-
-    isMounted = true
   })
 
   $effect(() => {
-    if (!isMounted) return
+    if (!locale) return
 
     document.documentElement.lang = $LL.meta.lang()
     document.title = $LL.meta.title()
@@ -144,26 +142,30 @@
   }
 
   async function copyCommand(command) {
+    copiedCommand = command
+    copyFallbackCommand = undefined
+
     try {
       await navigator.clipboard.writeText(command)
-      copiedCommand = command
       window.setTimeout(() => {
         if (copiedCommand === command) copiedCommand = undefined
       }, 1800)
     } catch {
-      copiedCommand = undefined
+      copyFallbackCommand = command
+      window.prompt($LL.download.copyPrompt(), command)
     }
   }
 </script>
 
-{#if locale && isMounted}
+{#if locale}
   <main class="site">
     <header class="site-nav" id="top">
       <a class="brand" href="#top" onclick={(event) => scrollToSection(event, 'top')}>ServerBox</a>
       <nav>
         <a href="#features" onclick={(event) => scrollToSection(event, 'features')}>{$LL.nav.features()}</a>
         <a href="#capabilities" onclick={(event) => scrollToSection(event, 'capabilities')}>{$LL.nav.capabilities()}</a>
         <a href="#download" onclick={(event) => scrollToSection(event, 'download')}>{$LL.nav.download()}</a>
+        <a href="/docs/">Docs</a>
       </nav>
       <div class="nav-actions">
         <label class="language-switcher">
@@ -270,7 +272,15 @@
                     aria-label={`${group.label} ${source.label}`}
                     onclick={() => copyCommand(source.command)}
                   >
-                    <span>{copiedCommand === source.command ? $LL.download.copied() : source.label}</span>
+                    <span>
+                      {#if copyFallbackCommand === source.command}
+                        {source.command}
+                      {:else if copiedCommand === source.command}
+                        {$LL.download.copied()}
+                      {:else}
+                        {source.label}
+                      {/if}
+                    </span>
                   </button>
                 {:else}
                   <a class="download-icon-btn" href={source.href} aria-label={`${group.label} ${source.label}`}>

website/src/app.css

@@ -1,4 +1,4 @@
-@import 'https://api.fontshare.com/v2/css?f[]=cabinet-grotesk@400,500,700,800&display=swap';
+@import url('https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;700;800&display=swap');
 
 :root {
   color-scheme: light;
@@ -18,8 +18,8 @@
   --radius-container: 12px;
   --radius-pill: 9999px;
 
-  --font-display: 'Cabinet Grotesk', 'SF Pro Rounded', system-ui, -apple-system, sans-serif;
-  --font-body: 'Cabinet Grotesk', ui-sans-serif, system-ui, -apple-system, sans-serif;
+  --font-display: 'Plus Jakarta Sans', 'SF Pro Rounded', system-ui, -apple-system, sans-serif;
+  --font-body: 'Plus Jakarta Sans', ui-sans-serif, system-ui, -apple-system, sans-serif;
   --font-mono: ui-monospace, 'SFMono-Regular', 'Menlo', 'Monaco', 'Consolas', monospace;
 }
 

website/src/i18n/en/index.ts

@@ -70,6 +70,7 @@ const en: BaseTranslation = {
     subtitle:
       'Choose the channel that matches your device and trust model. iOS and macOS use the App Store; Android, Linux, and Windows also have direct package downloads.',
     copied: 'Install command copied',
+    copyPrompt: 'Copy this install command:',
     note:
       'Only download packages from a source you trust. For server-side push, widgets, and companion monitoring, install ServerBoxMonitor separately on your servers.',
   },

website/src/i18n/i18n-types.ts

@@ -181,6 +181,10 @@ type RootTranslation = {
 		 * I​n​s​t​a​l​l​ ​c​o​m​m​a​n​d​ ​c​o​p​i​e​d
 		 */
 		copied: string
+		/**
+		 * C​o​p​y​ ​t​h​i​s​ ​i​n​s​t​a​l​l​ ​c​o​m​m​a​n​d​:
+		 */
+		copyPrompt: string
 		/**
 		 * O​n​l​y​ ​d​o​w​n​l​o​a​d​ ​p​a​c​k​a​g​e​s​ ​f​r​o​m​ ​a​ ​s​o​u​r​c​e​ ​y​o​u​ ​t​r​u​s​t​.​ ​F​o​r​ ​s​e​r​v​e​r​-​s​i​d​e​ ​p​u​s​h​,​ ​w​i​d​g​e​t​s​,​ ​a​n​d​ ​c​o​m​p​a​n​i​o​n​ ​m​o​n​i​t​o​r​i​n​g​,​ ​i​n​s​t​a​l​l​ ​S​e​r​v​e​r​B​o​x​M​o​n​i​t​o​r​ ​s​e​p​a​r​a​t​e​l​y​ ​o​n​ ​y​o​u​r​ ​s​e​r​v​e​r​s​.
 		 */
@@ -388,6 +392,10 @@ export type TranslationFunctions = {
 		 * Install command copied
 		 */
 		copied: () => LocalizedString
+		/**
+		 * Copy this install command:
+		 */
+		copyPrompt: () => LocalizedString
 		/**
 		 * Only download packages from a source you trust. For server-side push, widgets, and companion monitoring, install ServerBoxMonitor separately on your servers.
 		 */