Skip to content

Host index.html demo on GitHub Pages and add live demo link to README#35

Open
Aarya-Chaudhari wants to merge 2 commits intoAOSSIE-Org:mainfrom
Aarya-Chaudhari:main
Open

Host index.html demo on GitHub Pages and add live demo link to README#35
Aarya-Chaudhari wants to merge 2 commits intoAOSSIE-Org:mainfrom
Aarya-Chaudhari:main

Conversation

@Aarya-Chaudhari
Copy link
Contributor

@Aarya-Chaudhari Aarya-Chaudhari commented Feb 25, 2026

Addressed Issues:

Fixes #31

Screenshots/Recordings:

Screenshot 2026-02-25 175804 Screenshot 2026-02-25 175815

Additional Notes:

Hosted the existing index.html demo on GitHub Pages and added a live demo link to the README.

Changes Made
Created gh-pages branch for GitHub Pages deployment
Ensured index.html is accessible from the root for proper Pages hosting
Verified that all static assets (CSS/JS) load correctly in the hosted demo
Added a Live Demo section with the GitHub Pages URL in README.md

How to Test
Open the live demo link from the README
Verify the demo loads without cloning the repository
Check that styles, buttons, and configurations work as expected
Confirm no broken asset paths in the hosted version

Checklist

  • My PR addresses a single issue, fixes a single bug or makes a single improvement.
  • My code follows the project's code style and conventions
  • If applicable, I have made corresponding changes or additions to the documentation
  • If applicable, I have made corresponding changes or additions to tests
  • My changes generate no new warnings or errors
  • I have joined the Discord server and I will share a link to this PR with the project maintainers there
  • I have read the Contribution Guidelines
  • Once I submit my PR, CodeRabbit AI will automatically review it and I will address CodeRabbit's comments.

AI Usage Disclosure

Check one of the checkboxes below:

  • This PR does not contain AI-generated code at all.
  • This PR contains AI-generated code. I have tested the code locally and I am responsible for it.

I have used the following AI models and tools: TODO

⚠️ AI Notice - Important!

We encourage contributors to use AI tools responsibly when creating Pull Requests. While AI can be a valuable aid, it is essential to ensure that your contributions meet the task requirements, build successfully, include relevant tests, and pass all linters. Submissions that do not meet these standards may be closed without warning to maintain the quality and integrity of the project. Please take the time to understand the changes you are proposing and their impact.

Summary by CodeRabbit

  • Documentation
    • Added a Live Demo section to the README with a hyperlink to access the live demo.

@coderabbitai
Copy link

coderabbitai bot commented Feb 25, 2026

📝 Walkthrough

Walkthrough

Added a Live Demo section to the README that directs users to a GitHub Pages-hosted demo. This enables users to preview the SocialShareButton without cloning the repository, supporting the feature objective of providing accessible live demonstration access.

Changes

Cohort / File(s) Summary
Documentation
README.md
Added Live Demo section with hyperlink to GitHub Pages-hosted demo of index.html, providing easy access for users to view and test the SocialShareButton component.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

🐰 A demo link now hops in the README so bright,
Users can test without cloning overnight,
GitHub Pages serves the button with glee,
No setup needed—just click and see! 🎉

🚥 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 clearly summarizes the main changes: hosting the demo on GitHub Pages and adding a live demo link to README.
Linked Issues check ✅ Passed All coding requirements from issue #31 are met: the demo is hosted on GitHub Pages, the README has a Live Demo section with the GitHub Pages URL, and static assets are verified to load correctly.
Out of Scope Changes check ✅ Passed The only change is documentation-related (adding a Live Demo section to README), which is directly within scope of issue #31's requirement to add a demo link to the README.
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

@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)
README.md (2)

64-64: Format the URL as a named Markdown hyperlink.

A named link is more idiomatic and resilient than a bare URL in documentation.

♻️ Proposed formatting improvement
-🔗 https://aarya-chaudhari.github.io/SocialShareButton/
+[🔗 Live Demo](https://aarya-chaudhari.github.io/SocialShareButton/)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 64, Replace the bare URL on the README (the line
containing "https://aarya-chaudhari.github.io/SocialShareButton/") with a named
Markdown link; for example, convert it to a descriptive anchor like "[Live
demo](https://aarya-chaudhari.github.io/SocialShareButton/)" or "[Project
demo](...)" so the link is presented as a named hyperlink rather than a raw URL.

63-65: Consider consolidating with the existing ## Demo section (line 662).

There is already a ## Demo section at line 662 that references the local index.html and a YouTube tutorial. Adding a separate ## Live Demo at the top introduces two disconnected demo sections. Merging the hosted URL into the existing section would keep related information together.

♻️ Proposed consolidation (at existing Demo section)
 ## Demo

+🔗 [Live Demo](https://aarya-chaudhari.github.io/SocialShareButton/)
+
 Open `index.html` in your browser to see all features.
 Tutorial: https://youtu.be/cLJaT-8rEvQ?si=CLipA0Db4WL0EqKM

And remove the new standalone ## Live Demo block added above ## Features.

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

In `@README.md` around lines 63 - 65, Remove the standalone "## Live Demo" block
and instead add the hosted URL
(https://aarya-chaudhari.github.io/SocialShareButton/) into the existing "##
Demo" section (heading "## Demo"), placing it alongside the local index.html and
YouTube tutorial; ensure the "## Features" section remains directly after the
consolidated Demo content and update the table of contents if present to reflect
the single Demo entry.
🤖 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 63-64: Replace the personal GitHub Pages URL in README.md (the
string "https://aarya-chaudhari.github.io/SocialShareButton/") with the
organization-hosted Pages URL once org Pages are enabled (e.g.,
"https://aossie-org.github.io/SocialShareButton/") and update the "Live Demo"
section accordingly; ensure GitHub Pages is enabled for the
AOSSIE-Org/SocialShareButton repository before changing the link so the README
points to a stable, org-controlled demo URL.

---

Nitpick comments:
In `@README.md`:
- Line 64: Replace the bare URL on the README (the line containing
"https://aarya-chaudhari.github.io/SocialShareButton/") with a named Markdown
link; for example, convert it to a descriptive anchor like "[Live
demo](https://aarya-chaudhari.github.io/SocialShareButton/)" or "[Project
demo](...)" so the link is presented as a named hyperlink rather than a raw URL.
- Around line 63-65: Remove the standalone "## Live Demo" block and instead add
the hosted URL (https://aarya-chaudhari.github.io/SocialShareButton/) into the
existing "## Demo" section (heading "## Demo"), placing it alongside the local
index.html and YouTube tutorial; ensure the "## Features" section remains
directly after the consolidated Demo content and update the table of contents if
present to reflect the single Demo entry.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d73852d and 98f41e1.

📒 Files selected for processing (1)
  • README.md

Comment on lines +63 to +64
## Live Demo
🔗 https://aarya-chaudhari.github.io/SocialShareButton/
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

Demo URL points to a personal fork — should be hosted under the organization.

The URL https://aarya-chaudhari.github.io/SocialShareButton/ is served from the contributor's personal GitHub account, not the AOSSIE-Org organization. Publishing this in the org's README creates a fragile dependency: the link will permanently break if the contributor ever removes their fork or disables GitHub Pages, and the org has no ability to recover it.

GitHub Pages should be enabled on the AOSSIE-Org/SocialShareButton repository itself, so the demo lives at a stable, org-controlled URL (e.g., https://aossie-org.github.io/SocialShareButton/).

🔗 Proposed fix once org Pages are configured
-🔗 https://aarya-chaudhari.github.io/SocialShareButton/
+🔗 [https://aossie-org.github.io/SocialShareButton/](https://aossie-org.github.io/SocialShareButton/)
📝 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
## Live Demo
🔗 https://aarya-chaudhari.github.io/SocialShareButton/
## Live Demo
🔗 [https://aossie-org.github.io/SocialShareButton/](https://aossie-org.github.io/SocialShareButton/)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 63 - 64, Replace the personal GitHub Pages URL in
README.md (the string "https://aarya-chaudhari.github.io/SocialShareButton/")
with the organization-hosted Pages URL once org Pages are enabled (e.g.,
"https://aossie-org.github.io/SocialShareButton/") and update the "Live Demo"
section accordingly; ensure GitHub Pages is enabled for the
AOSSIE-Org/SocialShareButton repository before changing the link so the README
points to a stable, org-controlled demo URL.

@Aarya-Chaudhari
Copy link
Contributor Author

Actionable comments posted: 1

🧹 Nitpick comments (2)

README.md (2)> 64-64: Format the URL as a named Markdown hyperlink.

A named link is more idiomatic and resilient than a bare URL in documentation.

♻️ Proposed formatting improvement

-🔗 https://aarya-chaudhari.github.io/SocialShareButton/
+[🔗 Live Demo](https://aarya-chaudhari.github.io/SocialShareButton/)

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 64, Replace the bare URL on the README (the line
containing "https://aarya-chaudhari.github.io/SocialShareButton/") with a named
Markdown link; for example, convert it to a descriptive anchor like "[Live
demo](https://aarya-chaudhari.github.io/SocialShareButton/)" or "[Project
demo](...)" so the link is presented as a named hyperlink rather than a raw URL.

63-65: Consider consolidating with the existing ## Demo section (line 662).
There is already a ## Demo section at line 662 that references the local index.html and a YouTube tutorial. Adding a separate ## Live Demo at the top introduces two disconnected demo sections. Merging the hosted URL into the existing section would keep related information together.

♻️ Proposed consolidation (at existing Demo section)

 ## Demo

+🔗 [Live Demo](https://aarya-chaudhari.github.io/SocialShareButton/)
+
 Open `index.html` in your browser to see all features.
 Tutorial: https://youtu.be/cLJaT-8rEvQ?si=CLipA0Db4WL0EqKM

And remove the new standalone ## Live Demo block added above ## Features.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 63 - 65, Remove the standalone "## Live Demo" block
and instead add the hosted URL
(https://aarya-chaudhari.github.io/SocialShareButton/) into the existing "##
Demo" section (heading "## Demo"), placing it alongside the local index.html and
YouTube tutorial; ensure the "## Features" section remains directly after the
consolidated Demo content and update the table of contents if present to reflect
the single Demo entry.

🤖 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 63-64: Replace the personal GitHub Pages URL in README.md (the
string "https://aarya-chaudhari.github.io/SocialShareButton/") with the
organization-hosted Pages URL once org Pages are enabled (e.g.,
"https://aossie-org.github.io/SocialShareButton/") and update the "Live Demo"
section accordingly; ensure GitHub Pages is enabled for the
AOSSIE-Org/SocialShareButton repository before changing the link so the README
points to a stable, org-controlled demo URL.

---

Nitpick comments:
In `@README.md`:
- Line 64: Replace the bare URL on the README (the line containing
"https://aarya-chaudhari.github.io/SocialShareButton/") with a named Markdown
link; for example, convert it to a descriptive anchor like "[Live
demo](https://aarya-chaudhari.github.io/SocialShareButton/)" or "[Project
demo](...)" so the link is presented as a named hyperlink rather than a raw URL.
- Around line 63-65: Remove the standalone "## Live Demo" block and instead add
the hosted URL (https://aarya-chaudhari.github.io/SocialShareButton/) into the
existing "## Demo" section (heading "## Demo"), placing it alongside the local
index.html and YouTube tutorial; ensure the "## Features" section remains
directly after the consolidated Demo content and update the table of contents if
present to reflect the single Demo entry.

ℹ️ Review info

Thank you for the review.

Since external contributors cannot deploy GitHub Pages for the organization repository, the demo is currently hosted from my fork to demonstrate functionality.

The organization can later enable GitHub Pages on the main repository after merging this PR.

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.

[FEATURE]: Host index.html Demo on GitHub Pages

1 participant