Skip to content

Updated potpie-ui readme#330

Open
kshitij2040 wants to merge 2 commits intopotpie-ai:mainfrom
kshitij2040:main
Open

Updated potpie-ui readme#330
kshitij2040 wants to merge 2 commits intopotpie-ai:mainfrom
kshitij2040:main

Conversation

@kshitij2040
Copy link
Copy Markdown
Collaborator

@kshitij2040 kshitij2040 commented Feb 22, 2026

Summary by CodeRabbit

  • Documentation
    • Redesigned README with improved visual structure and layout
    • Added responsive logo display
    • Reorganized key sections (features, quick start, development guides) for better clarity
    • Introduced tabular formatting for enhanced readability
    • Streamlined contributing and license information

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Feb 22, 2026

Walkthrough

Restructures README.md with a responsive logo replacement, reorganizes content into modular table-driven sections, consolidates Quick Start instructions, replaces narrative Development and Production sections with tabular formats, and updates Contributing and License sections with visual elements and links.

Changes

Cohort / File(s) Summary
Documentation Restructuring
README.md
Replaced static logo with responsive picture element, reorganized Table of Contents, introduced hero section with features table, consolidated Quick Start with clarified commands, restructured Development/Production sections into tabular format with per-service details, simplified Contributing section with link to guide, and added separate License section header with visual badge.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

Poem

🐰 A README once cluttered and tall,
Now organized, streamlined for all,
With tables so neat and logos so bright,
The docs hop along, what a delightful sight! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'Updated potpie-ui readme' is vague and generic, using non-descriptive language that doesn't convey meaningful information about the specific changes made. Consider a more specific title that reflects the main changes, such as 'Restructure README with table-based layouts and new hero section' or 'Refactor README documentation with improved visual hierarchy'.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches
🧪 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
Copy Markdown
Contributor

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

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

Inline comments:
In `@README.md`:
- Around line 72-84: Remove the redundant pnpm build step from the Quick Start
command block: in the section that currently lists "pnpm install", "pnpm build",
"pnpm run dev", delete the "pnpm build" line so the sequence becomes "pnpm
install" then "pnpm run dev"; ensure the surrounding text and step numbering (if
present) remain correct and that the Production Mode section still retains the
existing "pnpm build" + "pnpm start" sequence.
- Around line 21-22: Update the two GitHub badge links in README.md that
currently point to potpie-ai/potpie: locate the anchor elements containing the
license badge (the <a
...href="https://github.com/potpie-ai/potpie/blob/main/LICENSE">... badge) and
the stars badge (the <a ...href="https://github.com/potpie-ai/potpie">... badge)
and change their hrefs to reference potpie-ai/potpie-ui (and the LICENSE path to
potpie-ai/potpie-ui/blob/main/LICENSE) so both badges point to this repository.
- Around line 3-7: The README's picture block references missing files and uses
paths that resolve outside the repo root; place the three missing images
(readme_logo_dark.svg, logo_light.svg, dashboard.gif) into the repository root
assets folder and update the <source> srcset and <img> src attributes in the
README's picture element (and any dashboard GIF reference) to use relative
in-repo paths like ./assets/readme_logo_dark.svg and ./assets/logo_light.svg (or
absolute assets/logo_light.svg), or alternatively replace those src/srcset
values with stable external URLs pointing to the images.

Comment on lines +3 to +7
<picture>
<source media="(prefers-color-scheme: dark)" srcset="../assets/readme_logo_dark.svg" />
<source media="(prefers-color-scheme: light)" srcset="../assets/logo_light.svg" />
<img src="../assets/logo_light.svg" alt="Potpie AI logo" />
</picture>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check where the assets directory is located
echo "=== Looking for assets directory ==="
fd -t d "assets"

echo -e "\n=== Checking all image references in markdown files ==="
rg -n "assets/" --glob "*.md" -C 1

echo -e "\n=== Checking all srcset and src attributes ==="
rg -n "(srcset|src)=" --glob "*.md" -C 1

echo -e "\n=== Full directory structure at repo root ==="
ls -la

Repository: potpie-ai/potpie-ui

Length of output: 4256


🏁 Script executed:

#!/bin/bash
# Verify the assets directory contains the referenced files
echo "=== Contents of assets directory ==="
ls -la assets/

echo -e "\n=== Confirm file existence ==="
test -f "assets/readme_logo_dark.svg" && echo "✓ readme_logo_dark.svg exists" || echo "✗ readme_logo_dark.svg missing"
test -f "assets/logo_light.svg" && echo "✓ logo_light.svg exists" || echo "✗ logo_light.svg missing"
test -f "assets/dashboard.gif" && echo "✓ dashboard.gif exists" || echo "✗ dashboard.gif missing"

Repository: potpie-ai/potpie-ui

Length of output: 396


Critical: Image files referenced in README are missing and paths are broken.

All image references use ../assets/… paths, which resolve outside the repository root on GitHub, breaking image display. Additionally, the referenced image files do not exist in the assets/ directory:

  • readme_logo_dark.svg — missing
  • logo_light.svg — missing
  • dashboard.gif — missing

The assets/ directory exists at the repository root but contains only home_page.png.

Either add the three missing image files to the assets/ directory and correct the paths to ./assets/… (or assets/…), or replace the image references with external URLs.

Affected lines: 4–6 (logo), 16 (dashboard)

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

In `@README.md` around lines 3 - 7, The README's picture block references missing
files and uses paths that resolve outside the repo root; place the three missing
images (readme_logo_dark.svg, logo_light.svg, dashboard.gif) into the repository
root assets folder and update the <source> srcset and <img> src attributes in
the README's picture element (and any dashboard GIF reference) to use relative
in-repo paths like ./assets/readme_logo_dark.svg and ./assets/logo_light.svg (or
absolute assets/logo_light.svg), or alternatively replace those src/srcset
values with stable external URLs pointing to the images.

Comment on lines +21 to +22
<a href="https://github.com/potpie-ai/potpie/blob/main/LICENSE"><img src="https://img.shields.io/github/license/potpie-ai/potpie" alt="Apache 2.0"></a>
<a href="https://github.com/potpie-ai/potpie"><img src="https://img.shields.io/github/stars/potpie-ai/potpie" alt="GitHub Stars"></a>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check for a LICENSE file in the repo root
fd -t f "LICENSE" --max-depth 1

Repository: potpie-ai/potpie-ui

Length of output: 70


🏁 Script executed:

# Also check the README to see the current state at lines 21-22
head -30 README.md | cat -n

Repository: potpie-ai/potpie-ui

Length of output: 1398


License and Stars badges reference the wrong repository.

Both the license badge (line 21) and stars badge (line 22) point to potpie-ai/potpie (the main backend repo) rather than potpie-ai/potpie-ui (this repo). A LICENSE file exists in this repository, so the badges should reference potpie-ai/potpie-ui for consistency.

Proposed fix
-  <a href="https://github.com/potpie-ai/potpie/blob/main/LICENSE"><img src="https://img.shields.io/github/license/potpie-ai/potpie" alt="Apache 2.0"></a>
-  <a href="https://github.com/potpie-ai/potpie"><img src="https://img.shields.io/github/stars/potpie-ai/potpie" alt="GitHub Stars"></a>
+  <a href="https://github.com/potpie-ai/potpie-ui/blob/main/LICENSE"><img src="https://img.shields.io/github/license/potpie-ai/potpie-ui" alt="Apache 2.0"></a>
+  <a href="https://github.com/potpie-ai/potpie-ui"><img src="https://img.shields.io/github/stars/potpie-ai/potpie-ui" alt="GitHub Stars"></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 href="https://github.com/potpie-ai/potpie/blob/main/LICENSE"><img src="https://img.shields.io/github/license/potpie-ai/potpie" alt="Apache 2.0"></a>
<a href="https://github.com/potpie-ai/potpie"><img src="https://img.shields.io/github/stars/potpie-ai/potpie" alt="GitHub Stars"></a>
<a href="https://github.com/potpie-ai/potpie-ui/blob/main/LICENSE"><img src="https://img.shields.io/github/license/potpie-ai/potpie-ui" alt="Apache 2.0"></a>
<a href="https://github.com/potpie-ai/potpie-ui"><img src="https://img.shields.io/github/stars/potpie-ai/potpie-ui" alt="GitHub Stars"></a>
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 21 - 22, Update the two GitHub badge links in
README.md that currently point to potpie-ai/potpie: locate the anchor elements
containing the license badge (the <a
...href="https://github.com/potpie-ai/potpie/blob/main/LICENSE">... badge) and
the stars badge (the <a ...href="https://github.com/potpie-ai/potpie">... badge)
and change their hrefs to reference potpie-ai/potpie-ui (and the LICENSE path to
potpie-ai/potpie-ui/blob/main/LICENSE) so both badges point to this repository.

Comment on lines +72 to +84
```bash
# 1. Clone the repository
git clone https://github.com/potpie-ai/potpie-ui.git
cd potpie-ui

# 2. Copy environment config
cp .env.template .env

# 3. Install dependencies and start
pnpm install
pnpm build
pnpm run dev
```
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Remove the redundant pnpm build step from the Quick Start.

pnpm build runs a full production build, which is unnecessary before pnpm run dev. This will confuse new contributors and double their onboarding time. The pnpm build + pnpm start sequence already appears correctly in the Production Mode section.

🐛 Proposed fix
 # 3. Install dependencies and start
 pnpm install
-pnpm build
 pnpm run dev
📝 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
```bash
# 1. Clone the repository
git clone https://github.com/potpie-ai/potpie-ui.git
cd potpie-ui
# 2. Copy environment config
cp .env.template .env
# 3. Install dependencies and start
pnpm install
pnpm build
pnpm run dev
```
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 72 - 84, Remove the redundant pnpm build step from
the Quick Start command block: in the section that currently lists "pnpm
install", "pnpm build", "pnpm run dev", delete the "pnpm build" line so the
sequence becomes "pnpm install" then "pnpm run dev"; ensure the surrounding text
and step numbering (if present) remain correct and that the Production Mode
section still retains the existing "pnpm build" + "pnpm start" sequence.

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