Skip to content

Conversation

@0x-Rahul
Copy link

@0x-Rahul 0x-Rahul commented Nov 13, 2025

Summary by CodeRabbit

  • New Features
    • Added a "How Orb Oracle Works?" three-step visual walkthrough: Multi-Source Aggregation, Validation & Signing, and On-Chain Publishing.
    • Replaced the previous Stats section with the new walkthrough and retained a CTA with an ArrowRight indicator.
    • Updated hero content and CTA composition (Get Started / Learn More) and standardized heading/text styling for a consistent look.

@coderabbitai
Copy link

coderabbitai bot commented Nov 13, 2025

Walkthrough

Replaced the Stats section in app/page.tsx with a three-step "How Orb Oracle Works?" walkthrough (Multi-Source Aggregation → Validation & Signing → On-Chain Publishing), updated hero CTA composition and minor JSX formatting/inline style normalization.

Changes

Cohort / File(s) Change Summary
How Orb Oracle Works Section
app/page.tsx
Removed previous Stats section; added a three-step walkthrough with headings, descriptions, decorative StepArrow SVG between steps, responsive layout (column on small screens, row on larger screens), and a concluding CTA with an ArrowRight indicator.
Hero / CTA adjustments & formatting
app/page.tsx
Reordered/reshaped hero content, changed inline style string quoting to double quotes, normalized font-style values, adjusted CTA composition (inline Link in Button for "Get Started", expanded Button wrapper for "Learn More"), and minor JSX spacing/prop formatting tweaks.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  participant User
  participant UI as Landing Page (app/page.tsx)
  participant Aggregator as Multi-Source Aggregation
  participant Validator as Validation & Signing
  participant Chain as On-Chain Publishing

  Note over UI: User views three-step walkthrough
  User->>UI: Clicks "Get Started" / "Learn More"
  UI->>Aggregator: Present aggregation overview (step 1)
  Aggregator-->>UI: Aggregation description shown
  UI->>Validator: Present validation & signing overview (step 2)
  Validator-->>UI: Validation description shown
  UI->>Chain: Present on-chain publishing overview (step 3)
  Chain-->>UI: Publishing description shown
  UI->>User: CTA triggers navigation (Get Started / Learn More)
Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Check responsive layout and spacing across breakpoints.
  • Verify StepArrow SVG rendering and alignment between steps.
  • Confirm CTA link composition and accessibility (focus/keyboard).
  • Review inline style string normalization for consistency.

Poem

🐰
I hop along the oracle's track,
Three glowing steps lead me back,
From many sources gathered tight,
Signed and sent into the light,
A joyous hop — the chain takes flight! ✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. You can run @coderabbitai generate docstrings to improve docstring coverage.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: replacing a Stats section with a new 'How Orb Oracle Works?' section that explains the three-step process, which is the primary modification in the changeset.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

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 and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (3)
app/page.tsx (3)

138-138: Use theme color variable instead of hardcoded RGB value.

The arrow stroke color rgb(147,197,253) is hardcoded, which makes it difficult to maintain consistency with the theme and doesn't adapt to theme changes.

Replace the hardcoded color with a CSS variable or Tailwind theme color:

-                    stroke="rgb(147,197,253)"
+                    stroke="currentColor"

And apply a text color class to the parent div:

-              <div className="hidden md:block absolute right-[-80px] top-[34px]">
+              <div className="hidden md:block absolute right-[-80px] top-[34px] text-blue-300">

Alternatively, use a CSS variable like stroke="hsl(var(--primary))" to match your theme system.

Also applies to: 164-164


120-185: Consider semantic HTML and extracting steps into a reusable component.

The current implementation could be improved for maintainability and accessibility:

  1. Semantic HTML: Consider using an ordered list (<ol>) with list items (<li>) instead of generic divs, as this represents a sequential process.
  2. Component extraction: The three steps are highly repetitive and could be mapped from a data array.
  3. Decorative SVGs: Add aria-hidden="true" to the arrow SVGs since they're purely decorative.

Example refactor:

const steps = [
  {
    number: 1,
    title: "Multi-Source Aggregation",
    description: "Orb Oracle pulls live prices from top exchanges, filters out bad data, and delivers a clean, reliable market value.",
    showArrow: true
  },
  {
    number: 2,
    title: "Validation & Signing",
    description: "Independent nodes verify each update and sign it with cryptography to ensure accuracy and security.",
    showArrow: true
  },
  {
    number: 3,
    title: "On-Chain Publishing",
    description: "The verified data is posted on-chain so smart contracts can access it instantly — no middlemen needed.",
    showArrow: false
  }
];

// Then map over the steps array to render each step

This improves maintainability and makes it easier to add or modify steps in the future.


189-189: Remove extra blank line.

There's an unnecessary extra blank line between sections. While this doesn't affect functionality, removing it would maintain consistent spacing throughout the file.

-
-
 
       {/* CTA Section */}
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e32af44 and 7ca8c5a.

📒 Files selected for processing (1)
  • app/page.tsx (3 hunks)
🔇 Additional comments (2)
app/page.tsx (2)

15-27: LGTM!

The inline style adjustments for the Orb container are syntactically correct and improve the consistency of the layout.


43-43: LGTM!

The heading text update is clear and properly formatted.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (2)
app/page.tsx (2)

132-176: Consider accessibility improvements for the workflow section.

The numbered circles and decorative arrows lack semantic markup and ARIA attributes, which could impact screen reader users.

Consider these improvements:

  1. Add aria-hidden="true" to the decorative SVG in StepArrow component
  2. Add descriptive aria-label attributes to the numbered circles
  3. Consider using semantic <ol> markup for the step sequence

Example for Step 1:

-            <div className="flex-1 flex flex-col items-center px-6 relative">
-              <div className="w-14 h-14 rounded-full bg-primary flex items-center justify-center text-black font-semibold text-lg shadow-md mb-6">
+            <div className="flex-1 flex flex-col items-center px-6 relative" role="listitem">
+              <div className="w-14 h-14 rounded-full bg-primary flex items-center justify-center text-black font-semibold text-lg shadow-md mb-6" aria-label="Step 1">
                 1
               </div>

And in StepArrow:

-    <svg width="150" height="24" viewBox="0 0 150 24" fill="none">
+    <svg width="150" height="24" viewBox="0 0 150 24" fill="none" aria-hidden="true">

8-21: Consider parameterizing StepArrow positioning for future flexibility.

The hardcoded right-[-80px] top-[34px] positioning works for the current layout but may require changes if step content heights vary.

If you anticipate layout variations, consider accepting positioning props:

const StepArrow = ({ rightOffset = -80, topOffset = 34 }: { rightOffset?: number; topOffset?: number }) => (
  <div className="hidden md:block absolute" style={{ right: `${rightOffset}px`, top: `${topOffset}px` }}>
    <svg width="150" height="24" viewBox="0 0 150 24" fill="none">
      <path
        d="M0 12 H140 L130 4 M140 12 L130 20"
        stroke="rgb(147,197,253)"
        strokeWidth="2.5"
        strokeLinecap="round"
        strokeLinejoin="round"
      />
    </svg>
  </div>
);

This allows future adjustments without modifying the component.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 7ca8c5a and 5a76fed.

📒 Files selected for processing (1)
  • app/page.tsx (5 hunks)
🧰 Additional context used
🧬 Code graph analysis (1)
app/page.tsx (2)
components/navigation.tsx (1)
  • Navigation (7-40)
components/Orb.tsx (1)
  • Orb (13-288)
🔇 Additional comments (3)
app/page.tsx (3)

8-21: Well done extracting the StepArrow component!

This successfully addresses the previous review feedback about DRY violation. The component is clean and appropriately used in the workflow section.


31-53: Clean style normalization.

The inline style formatting has been normalized to use double quotes consistently. The Orb component integration remains correct.


67-74: Proper button composition.

The explicit asChild pattern with Link is the correct approach for shadcn/ui Button components.

@DengreSarthak
Copy link
Member

Please attach some photos for reference.

@0x-Rahul
Copy link
Author

Please attach some photos for reference.

@DengreSarthak I have attached screenshots showing the newly added “How Orb Oracle Works?” section that replaces the previous hardcoded stats.

image image

Please let me know if you’d like any additional views or adjustments.

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