Skip to content

prototype: Start a community wizard (ports the app's /start flow) - #4

Open
abullaisi wants to merge 1 commit into
mainfrom
feat/prototype-start-wizard
Open

prototype: Start a community wizard (ports the app's /start flow)#4
abullaisi wants to merge 1 commit into
mainfrom
feat/prototype-start-wizard

Conversation

@abullaisi

@abullaisi abullaisi commented Jul 16, 2026

Copy link
Copy Markdown
Collaborator

Adds the missing creator-side flow to the clickable prototype: a 3-step "Start a community" wizard at prototype/start.html, ported from the real app's /start (same steps, same copy: Welcome > Brand > You are live).

  • Uses the existing stepper classes, pay-col centered column, and K state layer (wallet gate, 1.2s fake signing, k_creator_brand in localStorage, logActivity entry)
  • index.html's "09 FOR PARTNERS" placeholder CTA now links here ("Start a community")
  • SPEC.md: Screen 8 brief appended
  • Verified: full click-through on localhost (guard > connect > wizard > success), zero raw hex, zero em dashes, one primary per card

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added a “Start a community” onboarding flow with Welcome, Brand, and Live steps.
    • Added wallet connection guidance and a reset-demo option.
    • Added community name entry, validation, and simulated setup progression.
    • Added links and actions for reviewing the newly created community.
  • Improvements

    • Updated the main call-to-action to direct creators to the new community setup experience.
  • Documentation

    • Documented the onboarding screens, wallet behavior, steps, and available actions.

3-step onboarding (Welcome > Brand > You are live) in prototype idiom:
real stepper classes, pay-col centered column, K state gate + fake tx,
k_creator_brand persistence. Wires the 09 FOR PARTNERS placeholder CTA
on index.html to the new screen. SPEC.md gets the Screen 8 brief.
Copy ported verbatim from packages/web /start.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 16, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
stellar-hackathon-web Ready Ready Preview, Comment Jul 16, 2026 9:17am

@coderabbitai

coderabbitai Bot commented Jul 16, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Adds a wallet-gated three-step community onboarding page, connects the existing creator CTA to it, and implements community-name validation, local storage, activity logging, and live-state progression.

Changes

Community onboarding

Layer / File(s) Summary
Onboarding specification and entry point
prototype/SPEC.md, prototype/index.html
Documents the Screen 8 onboarding requirements and changes the creator CTA to link to start.html.
Wizard page and wallet guard
prototype/start.html
Adds the page structure, Welcome/Brand/Live cards, stepper, wallet guard, reset action, and wallet connection handling.
Community creation and live state
prototype/start.html
Validates and stores the community name, logs activity, updates the Live card, and advances through the wizard.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  actor Creator
  participant starthtml as start.html
  participant K
  participant BrowserStorage as localStorage
  Creator->>starthtml: Start a community
  starthtml->>K: Check connected wallet
  Creator->>starthtml: Submit community name
  starthtml->>BrowserStorage: Save community name
  starthtml->>K: Log community creation activity
  starthtml->>starthtml: Advance to Live card
Loading

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title is concise and accurately summarizes the main change: adding the prototype start-a-community wizard ported from the app's /start flow.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/prototype-start-wizard

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@prototype/start.html`:
- Line 86: Update the brand text in the paragraph containing the live-name span
to use the consistently capitalized “Komunify” form instead of “komunify”.
- Line 26: Update the logo anchor in the shared topbar markup to match the
SPEC.md page skeleton exactly, removing the inline img element and preserving
the consistent logo link structure used across screens.
- Around line 92-94: Update the footer containing the reset-proto link to
restore the standard text prefix specified by the shared page skeleton in
SPEC.md, while preserving the existing “Reset demo” link.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: b06e6b62-9031-446b-a0b1-e9e0c6470a04

📥 Commits

Reviewing files that changed from the base of the PR and between a829fde and d99d708.

📒 Files selected for processing (3)
  • prototype/SPEC.md
  • prototype/index.html
  • prototype/start.html

Comment thread prototype/start.html
<body>
<main class="shell">
<div class="topbar">
<a class="logo" href="index.html"><img src="logo-mark.png" alt="" class="logo-mark">Komunify</a>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Align logo markup with the shared page skeleton.

The logo link includes an inline <img...> tag, which deviates from the SPEC.md shared page skeleton that dictates the topbar markup must remain identical on every screen.

🛠️ Proposed fix
-    <a class="logo" href="index.html"><img src="logo-mark.png" alt="" class="logo-mark">Komunify</a>
+    <a class="logo" href="index.html">Komunify</a>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<a class="logo" href="index.html"><img src="logo-mark.png" alt="" class="logo-mark">Komunify</a>
<a class="logo" href="index.html">Komunify</a>
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@prototype/start.html` at line 26, Update the logo anchor in the shared topbar
markup to match the SPEC.md page skeleton exactly, removing the inline img
element and preserving the consistent logo link structure used across screens.

Comment thread prototype/start.html
<section class="card center hidden" id="live-card">
<div class="num-label"><span class="num">12</span> LIVE</div>
<h2>You are live</h2>
<p><span id="live-name">Your community</span> is now on komunify.</p>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Capitalize the brand name.

Ensure the brand name is consistently capitalized.

📝 Proposed fix
-      <p><span id="live-name">Your community</span> is now on komunify.</p>
+      <p><span id="live-name">Your community</span> is now on Komunify.</p>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<p><span id="live-name">Your community</span> is now on komunify.</p>
<p><span id="live-name">Your community</span> is now on Komunify.</p>
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@prototype/start.html` at line 86, Update the brand text in the paragraph
containing the live-name span to use the consistently capitalized “Komunify”
form instead of “komunify”.

Comment thread prototype/start.html
Comment on lines +92 to +94
<footer>
<a href="#" id="reset-proto">Reset demo</a>
</footer>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟠 Major | ⚡ Quick win

Restore missing footer text to match the shared skeleton.

The footer is missing the standard text prefix defined in the SPEC.md shared page skeleton. This omission breaks the expected global visual design contract.

🛠️ Proposed fix
   <footer>
+    <span class="label">Prototype</span> · Komunify on Stellar testnet ·
     <a href="#" id="reset-proto">Reset demo</a>
   </footer>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<footer>
<a href="#" id="reset-proto">Reset demo</a>
</footer>
<footer>
<span class="label">Prototype</span> · Komunify on Stellar testnet ·
<a href="#" id="reset-proto">Reset demo</a>
</footer>
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@prototype/start.html` around lines 92 - 94, Update the footer containing the
reset-proto link to restore the standard text prefix specified by the shared
page skeleton in SPEC.md, while preserving the existing “Reset demo” link.

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