Skip to content

fix: clarify onboarding prompts and product claims - #216

Draft
Sma1lboy wants to merge 3 commits into
mainfrom
fix/onboarding-prompt-copy
Draft

Sma1lboy wants to merge 3 commits into
mainfrom
fix/onboarding-prompt-copy

Conversation

@Sma1lboy

@Sma1lboy Sma1lboy commented Oct 1, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Fix the onboarding copy from the UX-writing audit: describe what CodeFox does without promising a specific agent, a key-free setup, or a first-minute result. Make the prompt actions and input labels clear.

Before / after

Before After
“Claude Code inside”, “0 cloud keys required”, “All of it happens on your machine” Self-hostable, provider-neutral copy with an explicit model-provider setup requirement
“Enhance” silently returns after a failure “Improve prompt” → “Improving prompt…” → success, or an inline retryable error that keeps the original text
Empty Create/Enhance can open sign-in or do nothing “Describe your project first.” before authentication
“Keep typing — sends when the agent finishes this turn” Explains that Enter or Send explicitly queues the next message
Inputs have only animated or disappearing hints Stable accessible names; the project prompt also has a visible label
Mixed Chinese/English model shortcuts and “multi” “Fast”, “Max”, and “Select all that apply”

The shared sign-in chooser stays neutral because both creation and prompt improvement use it.

Validation

Final head: 5318d2e84137dc57e70e747c02cf0d898031df57.

  • Strict exact-head integration passed after locally combining this head with CI repair #221 at f5ea2bfdf2037ace6ad50f6c3c7feaa9df0693d9. No integration commit was pushed.
  • Focused frontend: 8/8 passed. Full backend: 278/278 passed. Frontend/backend TypeScript and both production builds passed.
  • Source guards: 42/42 passed. Changed-file ESLint: 0 errors, 14 warnings. Real stage outcomes and raw logs are retained, with no continue-on-error masking acceptance checks.
  • The same eight real-component tests fail against exact baseline dd33611. Source regressions also failed before the fixes.
  • Final Node requirement correction: landing and README now say Node 22+, grounded in the locked @ai-sdk/harness, harness adapters, @ai-sdk/sandbox-vercel, and ai@7.0.37 engine declarations (>=22). This is not inferred solely from the CI runtime. The new guard fails against the prior feature tree and passes on this head; no dependency or lockfile changes.
  • Browser evidence: 8 reviewed raw before/after PNGs for hero, empty submit, authentication choice, and compact prompt form. Exact baseline dd33611 and final 5318d2e, actual Next pages, synthetic local GraphQL fixtures, zero mutations. Readiness metadata confirms loaded fonts, decoded product images, and loaded hero backgrounds before capture.
  • Vercel preview reports success for this exact head.

Ordinary checks on this independent branch still use old main workflows and remain red. Review/merge #221 first, then update/recheck feature branches. The clean integration result is not a claim that those old checks are green.

Scope

Independent branch from main; no dependency on the other audit-fix PRs. This does not change providers, model credentials, authentication policy, or project visibility. No paid generation or production account actions were used for testing.

Draft for review. Validation and before/after evidence are complete; no merge or production release was performed.

@vercel

vercel Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
codefox Ready Ready Preview Oct 1, 2026 10:18am UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — 5318d2e8 Deployed Oct 1, 2026 by vercel[bot]
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.

1 participant