pal-e-docs

macbook-ssh

macbook-ssh forgejo

Repository Board

Notes

Project Page 1
  • Project: macbook-ssh project-macbook-ssh

    Vision

    Ship every pal-e Rails web app to the iOS App Store through a repeatable pipeline. Web-first — the Rails app deploys to k3s before any iOS work begins. The iOS app is a thin Turbo Native shell that loads the production URL. One codebase on the server, one native wrapper per app.

    User Stories

    Key Story Note Role Success Metric
    ios-dev-build story-macbook-ssh-ios-dev-build Developer Rails app loads on physical iPhone via Xcode dev build

    Architecture

    arch-turbo-native-macbook-ssh — Turbo Native iOS shell component

    Full pipeline diagram in repo: docs/ios-pipeline.md

    Key decisions:

    • Turbo Native — Rails apps use Hotwire, native shell loads server-rendered HTML
    • MacBook as build agent — Xcode requires macOS, SSH from archbox
    • Fastlane for automation — build, sign, upload to TestFlight/App Store

    Board

    board-macbook-ssh — iOS Pipeline

    Status

    • SSH access to MacBook established (Tailscale)
    • Xcode 26.4 + iOS 26.4 simulators ready
    • Pipeline documentation complete
    • Apple Developer enrollment in progress
    • First target: landscaping-assistant dev build on iPhone

    Milestones

    None yet. First milestone: landscaping-assistant running on physical iPhone.

    Repos

    Repo Platform Role Status
    macbook-ssh Forgejo iOS pipeline docs, scripts, SSH config Active
    landscaping-assistant Forgejo First Rails app target for iOS Deployed (auth in progress)
Doc 2
  • Architecture: Turbo Native iOS Shell arch-turbo-native-macbook-ssh

    Component: turbo-native

    Thin Swift iOS shell using hotwire-native-ios. Loads server-rendered Rails HTML via Turbo Native sessions. One Xcode project per app, ~50 lines of meaningful Swift. Built on MacBook, deployed to iPhone via Xcode (dev) or Fastlane (TestFlight/App Store).

    Diagram

    Rails App (k3s) --[HTTPS]--> Turbo Native (iOS) --[WKWebView]--> User
                                    |
                              Xcode / Fastlane
                                    |
                         iPhone (dev) / TestFlight / App Store
  • User Story: iOS Dev Build on Phone story-macbook-ssh-ios-dev-build

    Key

    ios-dev-build

    Story

    As a developer, I want to deploy my Rails web apps to my physical iPhone via Xcode so that I can validate the native experience before submitting to the App Store.

    Acceptance Criteria

    • Turbo Native Xcode project loads the production Rails URL
    • App installs on physical iPhone via USB
    • Navigation, auth, and core flows work in the native shell
    • Process is repeatable for any Rails app on the platform
Board 1