fix tool iframes

README.md

@@ -4,11 +4,28 @@ Toes is a personal web server you run in your home.
 
 Plug it in, turn it on, and forget about the cloud.
 
-## quickstart
+## setup
 
-1. Plug in and turn on your Toes computer.
+Toes runs on a Raspberry Pi. You'll need:
-2. Tell Toes about your WiFi by <using dark @probablycorey magick>.
+
-3. Visit https://toes.local to get started!
+- A Raspberry Pi running Raspberry Pi OS
+- A `toes` user with passwordless sudo
+
+SSH into your Pi as the `toes` user and run:
+
+```bash
+curl -fsSL https://toes.dev/install | bash
+```
+
+This will:
+
+1. Install system dependencies (git, fish shell, networking tools)
+2. Install Bun and grant it network binding capabilities
+3. Clone and build the toes server
+4. Set up bundled apps (clock, code, cron, env, stats, versions)
+5. Install and enable a systemd service for auto-start
+
+Once complete, visit `http://<hostname>.local` on your local network.
 
 ## features
 - Hosts bun/hono/hype webapps - both SSR and SPA.

install/bun.lock

@@ -0,0 +1,26 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "toes-install",
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5.9.3",
+      },
+    },
+  },
+  "packages": {
+    "@types/bun": ["@types/bun@1.3.9", "https://npm.nose.space/@types/bun/-/bun-1.3.9.tgz", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
+
+    "@types/node": ["@types/node@25.3.2", "https://npm.nose.space/@types/node/-/node-25.3.2.tgz", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-RpV6r/ij22zRRdyBPcxDeKAzH43phWVKEjL2iksqo1Vz3CuBUrgmPpPhALKiRfU7OMCmeeO9vECBMsV0hMTG8Q=="],
+
+    "bun-types": ["bun-types@1.3.9", "https://npm.nose.space/bun-types/-/bun-types-1.3.9.tgz", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
+
+    "typescript": ["typescript@5.9.3", "https://npm.nose.space/typescript/-/typescript-5.9.3.tgz", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.18.2", "https://npm.nose.space/undici-types/-/undici-types-7.18.2.tgz", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
+  }
+}

install/install.sh

@@ -3,7 +3,7 @@ set -euo pipefail
 
 ##
 # toes installer
-# Usage: curl -sSL https://toes.space/install | bash
+# Usage: curl -sSL https://toes.dev/install | bash
 # Must be run as the 'toes' user.
 
 DEST=~/toes
@@ -91,12 +91,16 @@ echo ">> Installing bundled apps"
 BUNDLED_APPS="clock code cron env stats versions"
 for app in $BUNDLED_APPS; do
   if [ -d "$DEST/apps/$app" ]; then
+    if [ -d ~/apps/"$app" ]; then
+      echo "   $app (exists, skipping)"
+      continue
+    fi
     echo "   $app"
     cp -r "$DEST/apps/$app" ~/apps/
-    version_dir=$(ls -1 ~/apps/$app | grep -E '^[0-9]{8}-[0-9]{6}$' | sort -r | head -1)
+    version_dir=$(ls -1 ~/apps/"$app" | grep -E '^[0-9]{8}-[0-9]{6}$' | sort -r | head -1)
     if [ -n "$version_dir" ]; then
-      ln -sfn "$version_dir" ~/apps/$app/current
+      ln -sfn "$version_dir" ~/apps/"$app"/current
-      (cd ~/apps/$app/current && bun install --frozen-lockfile) > /dev/null 2>&1 || true
+      (cd ~/apps/"$app"/current && bun install --frozen-lockfile) > /dev/null 2>&1 || true
     fi
   fi
 done

install/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "toes-install",
+  "version": "0.0.1",
+  "description": "install toes",
+  "module": "server.ts",
+  "type": "module",
+  "scripts": {
+    "start": "bun run server.ts"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

install/server.ts

@@ -10,7 +10,7 @@ Bun.serve({
         headers: { "content-type": "text/plain" },
       })
     }
-    return new Response("toes", { status: 404 })
+    return new Response("404 Not Found", { status: 404 })
   },
 })
 

install/tsconfig.json

@@ -0,0 +1,43 @@
+{
+  "exclude": ["apps", "templates"],
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": [
+      "ESNext",
+      "DOM"
+    ],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "jsxImportSource": "hono/jsx",
+    "allowJs": true,
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false,
+    "baseUrl": ".",
+    "paths": {
+      "$*": [
+        "./src/server/*"
+      ],
+      "@*": [
+        "./src/shared/*"
+      ],
+      "%*": [
+        "./src/lib/*"
+      ]
+    }
+  }
+}

scripts/config.sh

@@ -6,8 +6,8 @@ TOES_USER="${TOES_USER:-toes}"
 HOST="${HOST:-toes.local}"
 SSH_HOST="$TOES_USER@$HOST"
 URL="${URL:-http://$HOST}"
-DEST="${DEST:-~/toes}"
+DEST="${DEST:-$HOME/toes}"
-DATA_DIR="${DATA_DIR:-~/data}"
+DATA_DIR="${DATA_DIR:-$HOME/data}"
-APPS_DIR="${APPS_DIR:-~/apps}"
+APPS_DIR="${APPS_DIR:-$HOME/apps}"
 
 mkdir -p "$DEST" "$DATA_DIR" "$APPS_DIR"

src/client/components/AppDetail.tsx

@@ -2,13 +2,14 @@ import { define } from '@because/forge'
 import type { App } from '../../shared/types'
 import { buildAppUrl } from '../../shared/urls'
 import { restartApp, shareApp, startApp, stopApp, unshareApp } from '../api'
-import { openAppSelectorModal, openDeleteAppModal, openRenameAppModal } from '../modals'
+import { openDeleteAppModal, openRenameAppModal } from '../modals'
-import { apps, getSelectedTab, isNarrow } from '../state'
+import { apps, getSelectedTab, isNarrow, setMobileSidebar } from '../state'
 import {
   ActionBar,
-  AppSelectorChevron,
   Button,
   ClickableAppName,
+  HamburgerButton,
+  HamburgerLine,
   HeaderActions,
   InfoLabel,
   InfoRow,
@@ -52,14 +53,15 @@ export function AppDetail({ app, render }: { app: App, render: () => void }) {
     <Main>
       <MainHeader>
         <MainTitle>
-          <OpenEmojiPicker app={app} render={render}>{app.icon}</OpenEmojiPicker>
-          &nbsp;
-          <ClickableAppName onClick={() => openRenameAppModal(app)}>{app.name}</ClickableAppName>
           {isNarrow && (
-            <AppSelectorChevron onClick={() => openAppSelectorModal(render)}>
+            <HamburgerButton onClick={() => { setMobileSidebar(true); render() }} title="Show apps">
-              ▼
+              <HamburgerLine />
-            </AppSelectorChevron>
+              <HamburgerLine />
+              <HamburgerLine />
+            </HamburgerButton>
           )}
+          <OpenEmojiPicker app={app} render={render}>{app.icon}</OpenEmojiPicker>
+          <ClickableAppName onClick={() => openRenameAppModal(app)}>{app.name}</ClickableAppName>
         </MainTitle>
         <HeaderActions>
           {!app.tool && (

src/client/components/AppSelector.tsx

@@ -2,7 +2,6 @@ import type { CSSProperties } from 'hono/jsx'
 import {
   apps,
   selectedApp,
-  setSelectedApp,
   setSidebarSection,
   sidebarSection,
 } from '../state'
@@ -17,19 +16,13 @@ import {
 interface AppSelectorProps {
   render: () => void
   onSelect?: () => void
-  onDashboard?: () => void
   collapsed?: boolean
+  large?: boolean
   switcherStyle?: CSSProperties
   listStyle?: CSSProperties
 }
 
-export function AppSelector({ render, onSelect, onDashboard, collapsed, switcherStyle, listStyle }: AppSelectorProps) {
+export function AppSelector({ render, onSelect, collapsed, large, switcherStyle, listStyle }: AppSelectorProps) {
-  const selectApp = (name: string) => {
-    setSelectedApp(name)
-    onSelect?.()
-    render()
-  }
-
   const switchSection = (section: 'apps' | 'tools') => {
     setSidebarSection(section)
     render()
@@ -43,18 +36,18 @@ export function AppSelector({ render, onSelect, onDashboard, collapsed, switcher
     <>
       {!collapsed && toolApps.length > 0 && (
         <SectionSwitcher style={switcherStyle}>
-          <SectionTab active={sidebarSection === 'apps' ? true : undefined} onClick={() => switchSection('apps')}>
+          <SectionTab active={sidebarSection === 'apps' ? true : undefined} large={large || undefined} onClick={() => switchSection('apps')}>
             Apps
           </SectionTab>
-          <SectionTab active={sidebarSection === 'tools' ? true : undefined} onClick={() => switchSection('tools')}>
+          <SectionTab active={sidebarSection === 'tools' ? true : undefined} large={large || undefined} onClick={() => switchSection('tools')}>
             Tools
           </SectionTab>
         </SectionSwitcher>
       )}
       <AppList style={listStyle}>
-        {collapsed && onDashboard && (
+        {collapsed && (
           <AppItem
-            onClick={onDashboard}
+            href="/"
             selected={!selectedApp ? true : undefined}
             style={{ justifyContent: 'center', padding: '10px 12px' }}
             title="Toes"
@@ -65,7 +58,9 @@ export function AppSelector({ render, onSelect, onDashboard, collapsed, switcher
         {activeApps.map(app => (
           <AppItem
             key={app.name}
-            onClick={() => selectApp(app.name)}
+            href={`/app/${app.name}`}
+            onClick={onSelect}
+            large={large || undefined}
             selected={app.name === selectedApp ? true : undefined}
             style={collapsed ? { justifyContent: 'center', padding: '10px 12px' } : undefined}
             title={collapsed ? app.name : undefined}
@@ -74,7 +69,7 @@ export function AppSelector({ render, onSelect, onDashboard, collapsed, switcher
               <span style={{ fontSize: 18 }}>{app.icon}</span>
             ) : (
               <>
-                <span style={{ fontSize: 14 }}>{app.icon}</span>
+                <span style={{ fontSize: large ? 20 : 14 }}>{app.icon}</span>
                 {app.name}
                 <StatusDot state={app.state} data-app={app.name} data-state={app.state} style={{ marginLeft: 'auto' }} />
               </>

src/client/components/Dashboard.tsx

@@ -1,13 +1,48 @@
 import { Styles } from '@because/forge'
-import { apps, currentView, isNarrow, selectedApp } from '../state'
+import { openNewAppModal } from '../modals'
-import { Layout } from '../styles'
+import { apps, currentView, isNarrow, mobileSidebar, selectedApp, setMobileSidebar } from '../state'
+import {
+  HamburgerButton,
+  HamburgerLine,
+  Layout,
+  Main,
+  MainContent as MainContentContainer,
+  MainHeader,
+  MainTitle,
+  NewAppButton,
+} from '../styles'
 import { AppDetail } from './AppDetail'
+import { AppSelector } from './AppSelector'
 import { DashboardLanding } from './DashboardLanding'
 import { Modal } from './modal'
 import { SettingsPage } from './SettingsPage'
 import { Sidebar } from './Sidebar'
 
+function MobileSidebar({ render }: { render: () => void }) {
+  return (
+    <Main>
+      <MainHeader>
+        <MainTitle>
+          <HamburgerButton onClick={() => { setMobileSidebar(false); render() }} title="Hide apps">
+            <HamburgerLine />
+            <HamburgerLine />
+            <HamburgerLine />
+          </HamburgerButton>
+          <a href="/" style={{ textDecoration: 'none', color: 'inherit' }}>🐾 Toes</a>
+        </MainTitle>
+      </MainHeader>
+      <MainContentContainer>
+        <AppSelector render={render} large />
+        <div style={{ padding: '12px 16px' }}>
+          <NewAppButton onClick={openNewAppModal}>+ New App</NewAppButton>
+        </div>
+      </MainContentContainer>
+    </Main>
+  )
+}
+
 function MainContent({ render }: { render: () => void }) {
+  if (isNarrow && mobileSidebar) return <MobileSidebar render={render} />
   const selected = apps.find(a => a.name === selectedApp)
   if (selected) return <AppDetail app={selected} render={render} />
   if (currentView === 'settings') return <SettingsPage render={render} />

src/client/components/DashboardLanding.tsx

@@ -1,8 +1,9 @@
 import { useEffect } from 'hono/jsx'
-import { openAppSelectorModal } from '../modals'
+import { navigate } from '../router'
-import { dashboardTab, isNarrow, setCurrentView, setDashboardTab, setSelectedApp } from '../state'
+import { dashboardTab, isNarrow, setMobileSidebar } from '../state'
 import {
-  AppSelectorChevron,
+  HamburgerButton,
+  HamburgerLine,
   DashboardContainer,
   DashboardHeader,
   DashboardTitle,
@@ -25,14 +26,11 @@ export function DashboardLanding({ render }: { render: () => void }) {
   const narrow = isNarrow || undefined
 
   const openSettings = () => {
-    setSelectedApp(null)
+    navigate('/settings')
-    setCurrentView('settings')
-    render()
   }
 
   const switchTab = (tab: typeof dashboardTab) => {
-    setDashboardTab(tab)
+    navigate(tab === 'urls' ? '/' : `/${tab}`)
-    render()
     if (tab === 'logs') scrollLogsToBottom()
   }
 
@@ -45,14 +43,20 @@ export function DashboardLanding({ render }: { render: () => void }) {
       >
         ⚙️
       </SettingsGear>
+      {isNarrow && (
+        <HamburgerButton
+          onClick={() => { setMobileSidebar(true); render() }}
+          title="Show apps"
+          style={{ position: 'absolute', top: 16, left: 16 }}
+        >
+          <HamburgerLine />
+          <HamburgerLine />
+          <HamburgerLine />
+        </HamburgerButton>
+      )}
       <DashboardHeader>
         <DashboardTitle narrow={narrow}>
           🐾 Toes
-          {isNarrow && (
-            <AppSelectorChevron onClick={() => openAppSelectorModal(render)}>
-              ▼
-            </AppSelectorChevron>
-          )}
         </DashboardTitle>
       </DashboardHeader>
 
@@ -63,7 +67,7 @@ export function DashboardLanding({ render }: { render: () => void }) {
       </TabBar>
 
       <TabContent active={dashboardTab === 'urls' || undefined}>
-        <Urls />
+        <Urls render={render} />
       </TabContent>
 
       <TabContent active={dashboardTab === 'logs' || undefined}>

src/client/components/Nav.tsx

@@ -1,5 +1,6 @@
 import type { App } from '../../shared/types'
-import { apps, getSelectedTab, setSelectedTab } from '../state'
+import { navigate } from '../router'
+import { apps, getSelectedTab } from '../state'
 import { Tab, TabBar } from '../styles'
 import { resetToolIframe } from '../tool-iframes'
 
@@ -12,8 +13,7 @@ export function Nav({ app, render }: { app: App; render: () => void }) {
       resetToolIframe(tab, app.name)
       return
     }
-    setSelectedTab(app.name, tab)
+    navigate(tab === 'overview' ? `/app/${app.name}` : `/app/${app.name}/${tab}`)
-    render()
   }
 
   // Find all tools

src/client/components/SettingsPage.tsx

@@ -1,6 +1,6 @@
 import { useEffect, useState } from 'hono/jsx'
 import { getWifiConfig, saveWifiConfig } from '../api'
-import { setCurrentView } from '../state'
+import { navigate } from '../router'
 import {
   Button,
   DashboardInstallCmd,
@@ -31,8 +31,7 @@ export function SettingsPage({ render }: { render: () => void }) {
   }, [])
 
   const goBack = () => {
-    setCurrentView('dashboard')
+    navigate('/')
-    render()
   }
 
   const handleSave = async (e: Event) => {

src/client/components/Sidebar.tsx

@@ -1,7 +1,5 @@
 import { openNewAppModal } from '../modals'
 import {
-  setCurrentView,
-  setSelectedApp,
   setSidebarCollapsed,
   sidebarCollapsed,
 } from '../state'
@@ -17,12 +15,6 @@ import {
 import { AppSelector } from './AppSelector'
 
 export function Sidebar({ render }: { render: () => void }) {
-  const goToDashboard = () => {
-    setSelectedApp(null)
-    setCurrentView('dashboard')
-    render()
-  }
-
   const toggleSidebar = () => {
     setSidebarCollapsed(!sidebarCollapsed)
     render()
@@ -40,7 +32,7 @@ export function Sidebar({ render }: { render: () => void }) {
         </div>
       ) : (
         <Logo>
-          <LogoLink onClick={goToDashboard} title="Go to dashboard">
+          <LogoLink href="/" title="Go to dashboard">
             🐾 Toes
           </LogoLink>
           <HamburgerButton onClick={toggleSidebar} title="Hide sidebar">
@@ -50,7 +42,7 @@ export function Sidebar({ render }: { render: () => void }) {
           </HamburgerButton>
         </Logo>
       )}
-      <AppSelector render={render} collapsed={sidebarCollapsed} onDashboard={goToDashboard} />
+      <AppSelector render={render} collapsed={sidebarCollapsed} />
       {!sidebarCollapsed && (
         <SidebarFooter>
           <NewAppButton onClick={openNewAppModal}>+ New App</NewAppButton>

src/client/components/Urls.tsx

@@ -1,16 +1,16 @@
 import { buildAppUrl } from '../../shared/urls'
-import { apps } from '../state'
+import { navigate } from '../router'
+import { apps, isNarrow } from '../state'
 import {
   EmptyState,
-  StatusDot,
+  Tile,
-  UrlLeft,
+  TileGrid,
-  UrlLink,
+  TileIcon,
-  UrlList,
+  TileName,
-  UrlPort,
+  TileStatus,
-  UrlRow,
 } from '../styles'
 
-export function Urls() {
+export function Urls({ render }: { render: () => void }) {
   const nonTools = apps.filter(a => !a.tool)
 
   if (nonTools.length === 0) {
@@ -18,25 +18,31 @@ export function Urls() {
   }
 
   return (
-    <UrlList>
+    <TileGrid narrow={isNarrow || undefined}>
       {nonTools.map(app => {
-        const url = buildAppUrl(app.name, location.origin)
+        const url = app.tunnelUrl || buildAppUrl(app.name, location.origin)
         const running = app.state === 'running'
+        const appPage = `/app/${app.name}`
+
+        const openAppPage = (e: MouseEvent) => {
+          e.preventDefault()
+          e.stopPropagation()
+          navigate(appPage)
+        }
 
         return (
-          <UrlRow key={app.name}>
+          <Tile
-            <UrlLeft>
+            key={app.name}
-              <StatusDot state={app.state} />
+            href={running ? url : appPage}
-              {running ? (
+            target={running ? '_blank' : undefined}
-                <UrlLink href={url} target="_blank">{url}</UrlLink>
+            narrow={isNarrow || undefined}
-              ) : (
+          >
-                <span style={{ color: 'var(--colors-textFaint)' }}>{app.name}</span>
+            <TileStatus state={app.state} onClick={openAppPage} />
-              )}
+            <TileIcon>{app.icon}</TileIcon>
-            </UrlLeft>
+            <TileName>{app.name}</TileName>
-            {app.port ? <UrlPort>:{app.port}</UrlPort> : null}
+          </Tile>
-          </UrlRow>
         )
       })}
-    </UrlList>
+    </TileGrid>
   )
 }

src/client/index.tsx

@@ -1,7 +1,8 @@
 import { render as renderApp } from 'hono/jsx/dom'
 import { Dashboard } from './components'
-import { apps, getSelectedTab, selectedApp, setApps, setIsNarrow, setSelectedApp } from './state'
 import { initModal } from './components/modal'
+import { initRouter, navigate } from './router'
+import { apps, getSelectedTab, selectedApp, setApps, setIsNarrow } from './state'
 import { initToolIframes, updateToolIframes } from './tool-iframes'
 import { initUpdate } from './update'
 
@@ -41,14 +42,16 @@ narrowQuery.addEventListener('change', e => {
   render()
 })
 
+// Initialize router (sets initial state from URL and renders)
+initRouter(render)
+
 // SSE connection
 const events = new EventSource('/api/apps/stream')
 events.onmessage = e => {
-  const prev = apps
   setApps(JSON.parse(e.data))
 
   if (selectedApp && !apps.some(a => a.name === selectedApp)) {
-    setSelectedApp(null)
+    navigate('/')
   }
 
   render()

src/client/modals/AppSelector.tsx

@@ -1,17 +0,0 @@
-import { closeModal, openModal } from '../components/modal'
-import { AppSelector } from '../components/AppSelector'
-
-let renderFn: () => void
-
-export function openAppSelectorModal(render: () => void) {
-  renderFn = render
-
-  openModal('Select App', () => (
-    <AppSelector
-      render={renderFn}
-      onSelect={closeModal}
-      switcherStyle={{ padding: '0 0 12px', marginLeft: -20, marginRight: -20, paddingLeft: 20, paddingRight: 20, marginBottom: 8 }}
-      listStyle={{ maxHeight: 300, overflow: 'auto' }}
-    />
-  ))
-}

src/client/modals/DeleteApp.tsx

@@ -1,6 +1,7 @@
 import type { App } from '../../shared/types'
 import { closeModal, openModal, rerenderModal } from '../components/modal'
-import { selectedApp, setSelectedApp } from '../state'
+import { navigate } from '../router'
+import { selectedApp } from '../state'
 import { Button, Form, FormActions, FormError, FormField, FormInput, FormLabel } from '../styles'
 import { theme } from '../themes'
 
@@ -32,11 +33,11 @@ async function deleteApp(input: HTMLInputElement) {
       throw new Error(`Failed to delete app: ${res.statusText}`)
     }
 
-    // Success - close modal and clear selection
+    // Success - close modal and navigate to dashboard
-    if (selectedApp === deleteAppTarget.name) {
-      setSelectedApp(null)
-    }
     closeModal()
+    if (selectedApp === deleteAppTarget.name) {
+      navigate('/')
+    }
   } catch (err) {
     deleteAppError = err instanceof Error ? err.message : 'Failed to delete app'
     deleteAppDeleting = false

src/client/modals/NewApp.tsx

@@ -1,5 +1,6 @@
 import { closeModal, openModal, rerenderModal } from '../components/modal'
-import { apps, setSelectedApp } from '../state'
+import { navigate } from '../router'
+import { apps } from '../state'
 import { Button, Form, FormActions, FormCheckbox, FormCheckboxField, FormCheckboxLabel, FormError, FormField, FormInput, FormLabel, FormSelect } from '../styles'
 
 type TemplateType = 'ssr' | 'spa' | 'bare'
@@ -48,9 +49,9 @@ async function createNewApp() {
       throw new Error(data.error || 'Failed to create app')
     }
 
-    // Success - close modal and select the new app
+    // Success - close modal and navigate to the new app
-    setSelectedApp(name)
     closeModal()
+    navigate(`/app/${name}`)
   } catch (err) {
     newAppError = err instanceof Error ? err.message : 'Failed to create app'
     newAppCreating = false

src/client/modals/RenameApp.tsx

@@ -1,6 +1,7 @@
 import type { App } from '../../shared/types'
 import { closeModal, openModal, rerenderModal } from '../components/modal'
-import { apps, setSelectedApp } from '../state'
+import { navigate } from '../router'
+import { apps } from '../state'
 import { Button, Form, FormActions, FormError, FormField, FormInput, FormLabel } from '../styles'
 
 let renameAppError = ''
@@ -58,9 +59,9 @@ async function doRenameApp(input: HTMLInputElement) {
       throw new Error(data.error || 'Failed to rename app')
     }
 
-    // Success - update selection and close modal
+    // Success - close modal and navigate to renamed app
-    setSelectedApp(data.name || newName)
     closeModal()
+    navigate(`/app/${data.name || newName}`)
   } catch (err) {
     renameAppError = err instanceof Error ? err.message : 'Failed to rename app'
     renameAppRenaming = false

src/client/modals/index.ts

@@ -1,4 +1,3 @@
-export { openAppSelectorModal } from './AppSelector'
 export { openDeleteAppModal } from './DeleteApp'
 export { openNewAppModal } from './NewApp'
 export { openRenameAppModal } from './RenameApp'

src/client/router.ts

@@ -0,0 +1,60 @@
+import { setCurrentView, setDashboardTab, setMobileSidebar, setSelectedApp, setSelectedTab } from './state'
+
+let _render: () => void
+
+export function navigate(href: string) {
+  history.pushState(null, '', href)
+  route()
+}
+
+export function initRouter(render: () => void) {
+  _render = render
+
+  // Intercept link clicks
+  document.addEventListener('click', e => {
+    const a = (e.target as Element).closest('a')
+    if (!a || !a.href || a.origin !== location.origin || a.target === '_blank') return
+    if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return
+    e.preventDefault()
+    history.pushState(null, '', a.href)
+    route()
+  })
+
+  // Handle back/forward
+  window.addEventListener('popstate', route)
+
+  // Initial route from URL
+  route()
+}
+
+function route() {
+  setMobileSidebar(false)
+  const path = location.pathname
+
+  if (path.startsWith('/app/')) {
+    const rest = decodeURIComponent(path.slice(5))
+    const slashIdx = rest.indexOf('/')
+    const name = slashIdx === -1 ? rest : rest.slice(0, slashIdx)
+    const tab = slashIdx === -1 ? 'overview' : rest.slice(slashIdx + 1)
+    setSelectedApp(name)
+    setSelectedTab(name, tab)
+    setCurrentView('dashboard')
+  } else if (path === '/settings') {
+    setSelectedApp(null)
+    setCurrentView('settings')
+  } else if (path === '/logs') {
+    setSelectedApp(null)
+    setDashboardTab('logs')
+    setCurrentView('dashboard')
+  } else if (path === '/metrics') {
+    setSelectedApp(null)
+    setDashboardTab('metrics')
+    setCurrentView('dashboard')
+  } else {
+    setSelectedApp(null)
+    setDashboardTab('urls')
+    setCurrentView('dashboard')
+  }
+
+  _render()
+}

src/client/state.ts

@@ -5,21 +5,21 @@ export type DashboardTab = 'urls' | 'logs' | 'metrics'
 // UI state (survives re-renders)
 export let currentView: 'dashboard' | 'settings' = 'dashboard'
 export let isNarrow: boolean = window.matchMedia('(max-width: 768px)').matches
-export let selectedApp: string | null = localStorage.getItem('selectedApp')
+export let selectedApp: string | null = null
 export let sidebarCollapsed: boolean = localStorage.getItem('sidebarCollapsed') === 'true'
-export let dashboardTab: DashboardTab = (localStorage.getItem('dashboardTab') as DashboardTab) || 'urls'
+export let dashboardTab: DashboardTab = 'urls'
+export let mobileSidebar: boolean = false
 export let sidebarSection: 'apps' | 'tools' = (localStorage.getItem('sidebarSection') as 'apps' | 'tools') || 'apps'
 
 // Server state (from SSE)
 export let apps: App[] = []
 
 // Tab state
-export let appTabs: Record<string, string> = JSON.parse(localStorage.getItem('appTabs') || '{}')
+export let appTabs: Record<string, string> = {}
 
 // State setters
 export function setDashboardTab(tab: DashboardTab) {
   dashboardTab = tab
-  localStorage.setItem('dashboardTab', tab)
 }
 
 export function setCurrentView(view: 'dashboard' | 'settings') {
@@ -28,17 +28,16 @@ export function setCurrentView(view: 'dashboard' | 'settings') {
 
 export function setSelectedApp(name: string | null) {
   selectedApp = name
-  if (name) {
-    localStorage.setItem('selectedApp', name)
-  } else {
-    localStorage.removeItem('selectedApp')
-  }
 }
 
 export function setIsNarrow(narrow: boolean) {
   isNarrow = narrow
 }
 
+export function setMobileSidebar(open: boolean) {
+  mobileSidebar = open
+}
+
 export function setSidebarCollapsed(collapsed: boolean) {
   sidebarCollapsed = collapsed
   localStorage.setItem('sidebarCollapsed', String(collapsed))
@@ -59,5 +58,4 @@ export const getSelectedTab = (appName: string | null) =>
 export function setSelectedTab(appName: string | null, tab: string) {
   if (!appName) return
   appTabs[appName] = tab
-  localStorage.setItem('appTabs', JSON.stringify(appTabs))
 }

src/client/styles/dashboard.ts

@@ -65,7 +65,6 @@ export const GaugeValue = define('GaugeValue', {
 // Unified Logs Section
 export const LogsSection = define('LogsSection', {
   width: '100%',
-  maxWidth: 800,
   flex: 1,
   minHeight: 0,
   display: 'flex',
@@ -203,58 +202,85 @@ export const LogStatus = define('LogStatus', {
   },
 })
 
-// URL List
+// App Tiles Grid
-export const UrlLeft = define('UrlLeft', {
+export const TileGrid = define('TileGrid', {
-  display: 'flex',
+  width: '100%',
-  alignItems: 'center',
+  maxWidth: 900,
-  gap: 8,
+  margin: '0 auto',
-  minWidth: 0,
+  display: 'grid',
-})
+  gridTemplateColumns: 'repeat(auto-fill, minmax(240px, 1fr))',
-
+  gap: 20,
-export const UrlLink = define('UrlLink', {
+  variants: {
-  base: 'a',
+    narrow: { gridTemplateColumns: '1fr' },
-  color: theme('colors-link'),
-  textDecoration: 'none',
-  overflow: 'hidden',
-  textOverflow: 'ellipsis',
-  whiteSpace: 'nowrap',
-  selectors: {
-    '&:hover': { textDecoration: 'underline' },
   },
 })
 
-export const UrlList = define('UrlList', {
+export const Tile = define('Tile', {
-  width: '100%',
+  base: 'a',
-  minWidth: 400,
+  position: 'relative',
-  maxWidth: 800,
   display: 'flex',
   flexDirection: 'column',
+  alignItems: 'center',
+  gap: 8,
+  padding: '28px 20px 24px',
   background: theme('colors-bgElement'),
   border: `1px solid ${theme('colors-border')}`,
   borderRadius: theme('radius-md'),
-  overflow: 'hidden',
+  textDecoration: 'none',
-})
+  cursor: 'pointer',
-
-export const UrlPort = define('UrlPort', {
-  fontFamily: theme('fonts-mono'),
-  fontSize: 12,
-  color: theme('colors-textFaint'),
-  flexShrink: 0,
-})
-
-export const UrlRow = define('UrlRow', {
-  display: 'flex',
-  justifyContent: 'space-between',
-  alignItems: 'center',
-  padding: '10px 16px',
-  fontFamily: theme('fonts-mono'),
-  fontSize: 13,
   selectors: {
     '&:hover': {
       background: theme('colors-bgHover'),
+      borderColor: theme('colors-textFaint'),
     },
-    '&:not(:last-child)': {
+  },
-      borderBottom: `1px solid ${theme('colors-border')}`,
+  variants: {
+    narrow: {
+      flexDirection: 'row',
+      alignItems: 'center',
+      padding: '16px 20px',
+      gap: 16,
+    },
+  },
+})
+
+export const TileIcon = define('TileIcon', {
+  fontSize: 48,
+  lineHeight: 1,
+  userSelect: 'none',
+})
+
+export const TileName = define('TileName', {
+  fontSize: 15,
+  fontWeight: 600,
+  color: theme('colors-text'),
+  textAlign: 'center',
+})
+
+export const TilePort = define('TilePort', {
+  fontFamily: theme('fonts-mono'),
+  fontSize: 13,
+  color: theme('colors-textFaint'),
+})
+
+export const TileStatus = define('TileStatus', {
+  position: 'absolute',
+  top: 8,
+  right: 8,
+  width: 2,
+  height: 2,
+  borderRadius: '50%',
+  cursor: 'pointer',
+  padding: 4,
+  backgroundClip: 'content-box',
+  variants: {
+    state: {
+      error: { background: theme('colors-statusInvalid') },
+      invalid: { background: theme('colors-statusInvalid') },
+      stopped: { background: theme('colors-statusStopped') },
+      starting: { background: theme('colors-statusStarting') },
+      running: { background: theme('colors-statusRunning') },
+      stopping: { background: theme('colors-statusStarting') },
     },
   },
 })

src/client/styles/index.ts

@@ -15,11 +15,12 @@ export {
   LogStatus,
   LogText,
   LogTimestamp,
-  UrlLeft,
+  Tile,
-  UrlLink,
+  TileGrid,
-  UrlList,
+  TileIcon,
-  UrlPort,
+  TileName,
-  UrlRow,
+  TilePort,
+  TileStatus,
   VitalCard,
   VitalLabel,
   VitalsSection,
@@ -28,7 +29,6 @@ export { Form, FormActions, FormCheckbox, FormCheckboxField, FormCheckboxLabel,
 export {
   AppItem,
   AppList,
-  AppSelectorChevron,
   ClickableAppName,
   DashboardContainer,
   DashboardHeader,

src/client/styles/layout.ts

@@ -29,7 +29,10 @@ export const Logo = define('Logo', {
 })
 
 export const LogoLink = define('LogoLink', {
+  base: 'a',
   cursor: 'pointer',
+  color: 'inherit',
+  textDecoration: 'none',
   borderRadius: theme('radius-md'),
   padding: '4px 8px',
   margin: '-4px -8px',
@@ -103,6 +106,7 @@ export const SectionTab = define('SectionTab', {
       background: theme('colors-bgSelected'),
       color: theme('colors-text'),
     },
+    large: { fontSize: 14, padding: '8px 12px' },
   },
 })
 
@@ -112,6 +116,7 @@ export const AppList = define('AppList', {
 })
 
 export const AppItem = define('AppItem', {
+  base: 'a',
   display: 'flex',
   flexDirection: 'row',
   alignItems: 'center',
@@ -125,6 +130,7 @@ export const AppItem = define('AppItem', {
     '&:hover': { background: theme('colors-bgHover'), color: theme('colors-text') },
   },
   variants: {
+    large: { fontSize: 18, padding: '12px 16px', gap: 12 },
     selected: { background: theme('colors-bgSelected'), color: theme('colors-text'), fontWeight: 500 },
   },
 })
@@ -166,20 +172,6 @@ export const MainTitle = define('MainTitle', {
   margin: 0,
 })
 
-export const AppSelectorChevron = define('AppSelectorChevron', {
-  base: 'button',
-  background: 'none',
-  border: 'none',
-  cursor: 'pointer',
-  padding: '4px 8px',
-  marginLeft: 4,
-  fontSize: 14,
-  color: theme('colors-textMuted'),
-  selectors: {
-    '&:hover': { color: theme('colors-text') },
-  },
-})
-
 export const ClickableAppName = define('ClickableAppName', {
   cursor: 'pointer',
   borderRadius: theme('radius-md'),
@@ -233,6 +225,7 @@ export const DashboardContainer = define('DashboardContainer', {
 
 export const DashboardHeader = define('DashboardHeader', {
   textAlign: 'center',
+  width: '100%',
 })
 
 export const DashboardTitle = define('DashboardTitle', {

src/client/styles/misc.ts

@@ -165,6 +165,7 @@ export const TabContent = define('TabContent', {
       display: 'flex',
       flexDirection: 'column',
       flex: 1,
+      width: '100%',
     }
   }
 })

src/server/api/events.ts

@@ -8,7 +8,11 @@ const router = Hype.router()
 // individual events so apps can react to specific lifecycle changes.
 router.sse('/stream', (send) => {
   const unsub = onEvent(event => send(event))
-  return unsub
+  const heartbeat = setInterval(() => send('', 'ping'), 60_000)
+  return () => {
+    clearInterval(heartbeat)
+    unsub()
+  }
 })
 
 export default router

src/server/index.tsx

@@ -7,6 +7,7 @@ import systemRouter from './api/system'
 import { Hype } from '@because/hype'
 import { cleanupStalePublishers } from './mdns'
 import { extractSubdomain, proxySubdomain, proxyWebSocket, websocket } from './proxy'
+import { Shell } from './shell'
 import type { Server } from 'bun'
 import type { WsData } from './proxy'
 
@@ -113,6 +114,13 @@ app.get('/dist/:file', async c => {
   })
 })
 
+// SPA routes — serve the shell for all client-side paths
+app.get('/app/:name/:tab', c => c.html(<Shell />))
+app.get('/app/:name', c => c.html(<Shell />))
+app.get('/logs', c => c.html(<Shell />))
+app.get('/metrics', c => c.html(<Shell />))
+app.get('/settings', c => c.html(<Shell />))
+
 cleanupStalePublishers()
 await initApps()
 

src/server/tunnels.ts

@@ -146,18 +146,19 @@ export function renameTunnelConfig(oldName: string, newName: string) {
   saveConfig(config)
 }
 
-function cancelReconnect(appName: string) {
+function cancelReconnect(appName: string, resetAttempts = true) {
   const timer = _reconnectTimers.get(appName)
   if (timer) {
     clearTimeout(timer)
     _reconnectTimers.delete(appName)
   }
-  _reconnectAttempts.delete(appName)
+  if (resetAttempts) _reconnectAttempts.delete(appName)
 }
 
-function openTunnel(appName: string, port: number, subdomain?: string) {
+function openTunnel(appName: string, port: number, subdomain?: string, isReconnect = false) {
   // Cancel any pending reconnect timer to prevent duplicate loops
-  cancelReconnect(appName)
+  // but preserve attempts counter during reconnection so backoff works
+  cancelReconnect(appName, !isReconnect)
 
   // Close existing tunnel if any
   const existing = _tunnels.get(appName)
@@ -232,7 +233,7 @@ function openTunnel(appName: string, port: number, subdomain?: string) {
         const config = loadConfig()
         if (!config[appName]) return
         hostLog(`Tunnel reconnecting: ${appName}`)
-        openTunnel(appName, port, config[appName]?.subdomain)
+        openTunnel(appName, port, config[appName]?.subdomain, true)
       }, delay)
 
       _reconnectTimers.set(appName, timer)

src/tools/events.ts

@@ -35,8 +35,10 @@ function ensureConnection() {
         buf = lines.pop()!
         for (const line of lines) {
           if (!line.startsWith('data: ')) continue
+          const payload = line.slice(6)
+          if (!payload) continue
           try {
-            const event: ToesEvent = JSON.parse(line.slice(6))
+            const event: ToesEvent = JSON.parse(payload)
             _listeners.forEach(l => {
               if (l.types.includes(event.type)) l.callback(event)
             })