Skip to content

Improve homepage UX and reorganize docs site#37

Merged
hackerwins merged 1 commit into
mainfrom
improve-homepage-and-docs
Mar 15, 2026
Merged

Improve homepage UX and reorganize docs site#37
hackerwins merged 1 commit into
mainfrom
improve-homepage-and-docs

Conversation

@hackerwins

@hackerwins hackerwins commented Mar 15, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Center-align check/x icons in the "Why Wafflebase?" comparison table
  • Link all feature cards to corresponding docs pages with hover effects
  • Reorganize docs sidebar into Guide (general users) and Developers (self-hosting, REST API, CLI)
  • Add new docs pages: Charts & Pivot Tables, Self-Hosting
  • Merge overlapping Collaboration and Sharing pages into a single "Collaboration & Sharing" page
  • Fix viewer description inconsistency and simplify technical jargon in user-facing docs

Test plan

  • pnpm verify:fast passes
  • Visual check: Why Wafflebase icons are centered in the table
  • Visual check: Feature cards link to correct docs pages
  • Docs site sidebar shows Guide / Developers sections correctly
  • New pages (charts, self-hosting) render properly in VitePress

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

  • New Features

    • Feature cards on the homepage now link directly to relevant documentation.
  • Documentation

    • Added new Self-Hosting guide for running Wafflebase on local infrastructure.
    • Added Charts & Pivot Tables guide covering data visualization and analysis.
    • Enhanced Collaboration & Sharing guide with improved sharing flow, access level management, link expiration, and share link management.
    • Reorganized navigation structure for improved discoverability.

- Center-align check/x icons in Why Wafflebase comparison table
- Link feature cards to corresponding docs pages with hover effects
- Reorganize docs sidebar: Guide (users) vs Developers (self-hosting,
  REST API, CLI)
- Add new docs: Charts & Pivot Tables, Self-Hosting
- Merge Collaboration and Sharing into a single page to remove overlap
- Fix viewer description inconsistency in sharing content
- Simplify technical jargon in user-facing docs

Co-Authored-By: Claude Opus 4.6 <[email protected]>
@coderabbitai

coderabbitai Bot commented Mar 15, 2026

Copy link
Copy Markdown
📝 Walkthrough

Walkthrough

This pull request updates navigation, documentation structure, and frontend homepage components. It adds self-hosting documentation, introduces a new Charts & Pivot Tables guide, reorganizes the sidebar navigation to group developer resources, updates collaboration guide content, and makes homepage feature cards navigable with href links.

Changes

Cohort / File(s) Summary
Navigation & Site Configuration
packages/docs/.vitepress/config.ts
Replaced "API Reference" navigation item with "Developers"; updated Guide sidebar label to "Collaboration & Sharing"; added "Charts & Pivot Tables" guide entry; reorganized Developers section grouping.
New Developer Documentation
packages/docs/developers/self-hosting.md
Added comprehensive self-hosting guide covering requirements, Docker Compose setup, environment variables, GitHub OAuth configuration, architecture, and data ownership.
New User Guide
packages/docs/guide/charts.md
Added detailed documentation for Charts and Pivot Tables functionality, including insertion, configuration, chart types, editor interface, and pivot table operations.
Updated Guides
packages/docs/guide/collaboration.md, packages/docs/guide/build-a-budget.md, packages/docs/guide/getting-started.md
Updated collaboration guide title and restructured share flow with new steps for access levels and link management; added "Manage Share Links" and "Good to Know" sections; updated references in other guides to reflect new collaboration guide naming and added Charts & Pivot Tables guide link.
Frontend Home Components
packages/frontend/src/app/home/features-section.tsx, packages/frontend/src/app/home/why-section.tsx
Added href properties to feature descriptors and converted feature cards from <div> to navigable <a> elements with transition classes; wrapped table cell content with flex-based centering divs.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Poem

🐰 Hop, skip, and a documentation leap!
New guides emerge from archives deep,
Self-hosting paths and charts so bright,
Links on features, navigation right,
Wafflebase hops towards the light! 📊

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ 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%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main changes: improving homepage UX (feature card links, icon alignment) and reorganizing the docs site (sidebar restructuring, new pages, page consolidation).
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
  • 📝 Generate docstrings (stacked PR)
  • 📝 Generate docstrings (commit on current branch)
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch improve-homepage-and-docs
📝 Coding Plan
  • Generate coding plan for human review comments

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.

@github-actions

github-actions Bot commented Mar 15, 2026

Copy link
Copy Markdown
Contributor

Verification: verify:self

Result: ✅ PASS in 96.6s

Lane Status Duration
sheet:build ✅ pass 13.2s
verify:fast ✅ pass 47.8s
frontend:build ✅ pass 13.7s
verify:frontend:chunks ✅ pass 0.3s
backend:build ✅ pass 4.5s
cli:build ✅ pass 1.8s
verify:entropy ✅ pass 15.2s

Verification: verify:integration

Result: ✅ PASS

@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: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@packages/docs/developers/self-hosting.md`:
- Around line 60-66: The fenced ASCII-art architecture block lacks a language
specifier causing MD040; update the opening fence for that block (the
triple-backtick that begins the Browser ──── Frontend... diagram in the
self-hosting.md file) to include a language identifier such as text (e.g.,
```text) so the code fence is properly annotated for the markdown linter.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c49bb9f1-4ac5-4046-852f-3cf36c2963f7

📥 Commits

Reviewing files that changed from the base of the PR and between 514c6f1 and 9c35165.

📒 Files selected for processing (10)
  • packages/docs/.vitepress/config.ts
  • packages/docs/developers/cli.md
  • packages/docs/developers/rest-api.md
  • packages/docs/developers/self-hosting.md
  • packages/docs/guide/build-a-budget.md
  • packages/docs/guide/charts.md
  • packages/docs/guide/collaboration.md
  • packages/docs/guide/getting-started.md
  • packages/frontend/src/app/home/features-section.tsx
  • packages/frontend/src/app/home/why-section.tsx

Comment on lines +60 to +66
```
Browser ──── Frontend (React/Vite) ──── Backend (NestJS)
┌─────┴─────┐
PostgreSQL Yorkie Server
(metadata) (CRDT sync)
```

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Add a language identifier to the architecture code fence.

Line 60 starts a fenced block without a language, which can trigger markdown lint failures (MD040).

💡 Suggested fix
-```
+```text
 Browser ──── Frontend (React/Vite) ──── Backend (NestJS)
                                               │
                                         ┌─────┴─────┐
                                    PostgreSQL    Yorkie Server
                                    (metadata)    (CRDT sync)
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **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.

```suggestion

🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 60-60: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@packages/docs/developers/self-hosting.md` around lines 60 - 66, The fenced
ASCII-art architecture block lacks a language specifier causing MD040; update
the opening fence for that block (the triple-backtick that begins the Browser
──── Frontend... diagram in the self-hosting.md file) to include a language
identifier such as text (e.g., ```text) so the code fence is properly annotated
for the markdown linter.

@hackerwins
hackerwins merged commit 7936f95 into main Mar 15, 2026
3 checks passed
@hackerwins
hackerwins deleted the improve-homepage-and-docs branch March 15, 2026 11:39
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