Skip to content

Add a one-screen landing page at /start/ for paid traffic - #283

Closed
pstayets wants to merge 1 commit into
TeoSlayer:mainfrom
pstayets:landing-start-variant
Closed

pstayets wants to merge 1 commit into
TeoSlayer:mainfrom
pstayets:landing-start-variant

Conversation

@pstayets

Copy link
Copy Markdown
Contributor

What changes for the user?

A new page at https://shell.online/start/ to test against the home page with paid traffic. The home page is unchanged.

Paid X traffic (utm_medium=paid_social) has been about 6,500 visitors a day, 98–99% on phones. It clicks a CTA about 0.05% of the time, and median time on the page is 1.4–1.6 seconds. /start/ fits on one phone screen and says only:

  • Use any coding agent from your phone. Free and open source. No account needed.
  • How it works:
    1. On your laptop, install shell: curl -fsSL https://shell.online/install | sh (with a Windows switch on laptops)
    2. Start your agent through shell: shell claude, or tap shell codex · shell hermes · shell opencode · shell cursor-agent to swap it in
    3. Scan the QR code it prints with this phone
  • On a phone, Send these steps to my laptop opens the share sheet with https://shell.online/start/. Where there's no share sheet, it copies the link instead. On a laptop the same page shows Copy buttons and no send button.

For the ads, link to https://shell.online/start/?utm_source=x&utm_medium=paid_social (plus twclid if X adds it).

Analytics

/start/ gets exactly what / gets, and nothing else does. shared/landing-paths.ts has one isLandingPath() check, and it's used everywhere / was hard-coded:

  • Worker CSP: the same Google Analytics, PostHog and X origins as /. The test checks that the policy is identical.
  • Google Analytics and first-party page_loaded, copy and cta_click events.
  • X base pixel. It's attributed to https://shell.online/start/, so the two pages can be compared in X Ads.
  • PostHog route start ($current_url https://shell.online/start/). Statistics dashboard label: landing_start.
  • New CTA target start_share for the send button.

The page is noindex (meta tag plus the Worker's existing X-Robots-Tag for non-document paths), so the home page stays the one search engines show.

Verification

  • npm run typecheck: passed.
  • npm test: 66 files, 756 tests passed; installer, Docker entrypoint, deploy guard, landing SEO and mobile-controls checks passed.
  • New tests: the X pixel loads on /start/ with page_location /start/, and not on /start, /start/extra or /start/?password=…; /start/ gets the same CSP as / plus noindex; PostHog route and $current_url; statistics label.
  • npm run build emits start/index.html with its own script and stylesheet. Checked in headless Chrome:
    • iPhone 13 (390×664): fits on one screen, no sideways scroll.
    • 1440×900: fits; the agent chips and Windows switch work.
    • iPhone SE: the page scrolls slightly, and the install command scrolls inside its box.
  • End to end with the current release on macOS: from a fresh HOME, the step 1 command installs, step 2 (shell <command>) starts a session, and scanning the QR code on a phone opens the terminal with no password to type.

Access and privacy

No change to sessions, terminal input, encryption or stored content. The new page loads only what the home page loads, under the same opt-out and Global Privacy Control / Do Not Track checks.

  • No real share links, credentials, private terminal content or deployment secrets are included.
  • The changelog is updated. No user docs change: this is a campaign page, not a feature.

Rollout

Needs a deploy. Add "/start/*" to assets.run_worker_first in wrangler.production.jsonc. Otherwise Cloudflare serves the page straight from assets, without the Worker's CSP or page counting, and npm run deploy:production refuses the config anyway, because it routes fewer paths than wrangler.example.jsonc.

To measure installs and sessions from the test, the relay also needs "POSTHOG_ENABLED": "1" in the same config (see #282). Without it, only page visits and clicks are recorded.

🤖 Generated with Claude Code

https://claude.ai/code/session_01ScihqCEjAhjFfkvfSR3ZXN

Paid X traffic is almost all phones, and on the home page it bounces in
about a second. /start/ is a shorter page to test against it: one line on
what shell does, then install, start your agent, and scan the QR code. On a
phone, "Send these steps to my laptop" opens the share sheet.

The page gets exactly what "/" gets: the same Content-Security-Policy,
Google Analytics, first-party events and X base pixel (attributed to
/start/). It reports as its own route ("start" in PostHog, "landing_start"
on the statistics dashboard) so the two pages can be compared, and it is
noindex so the home page stays the one search engines show.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ScihqCEjAhjFfkvfSR3ZXN
@pstayets

Copy link
Copy Markdown
Contributor Author

Combined into #285, with the other open fixes and the two flaky CI checks fixed.

@pstayets pstayets closed this Sep 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants