Skip to content

Conversation

@ibrahimcesar
Copy link
Owner

Implements automatic deployment of the demo to GitHub Pages with version synchronization on each release. The demo is now publicly accessible and automatically updated whenever a new version is published to npm.

Changes

GitHub Actions Workflow

  • Add deploy-demo.yml workflow for automated GitHub Pages deployment
  • Triggers on all releases (stable and pre-releases)
  • Updates demo to use the exact version from each release
  • Supports manual deployment with version override

Next.js Configuration

  • Configure basePath for GitHub Pages URL structure
  • Enable static export (output: 'export')
  • Optimize images for static hosting

Demo Improvements

  • Display current component version with npm/GitHub links
  • Add beta version banner for pre-release versions
  • Improve visual design with version badges
  • Show version-specific npm package links

Documentation

  • Add comprehensive GitHub Pages setup guide (.github/GITHUB_PAGES.md)
  • Update demo README with deployment information
  • Update main README with live demo link
  • Include troubleshooting and maintenance guides

Live Demo

https://ibrahimcesar.github.io/react-lite-youtube-embed

The demo automatically updates with each release, ensuring users always see the latest published version in action.

Benefits

✅ Automatic deployment on every release
✅ Version synchronization with npm package
✅ Beta/pre-release visual indicators
✅ Zero maintenance after setup
✅ Professional demo showcase
✅ Better user experience for evaluating the component

Closes #XXX (if applicable)

Implements automatic deployment of the demo to GitHub Pages with version
synchronization on each release. The demo is now publicly accessible and
automatically updated whenever a new version is published to npm.

## Changes

### GitHub Actions Workflow
- Add deploy-demo.yml workflow for automated GitHub Pages deployment
- Triggers on all releases (stable and pre-releases)
- Updates demo to use the exact version from each release
- Supports manual deployment with version override

### Next.js Configuration
- Configure basePath for GitHub Pages URL structure
- Enable static export (output: 'export')
- Optimize images for static hosting

### Demo Improvements
- Display current component version with npm/GitHub links
- Add beta version banner for pre-release versions
- Improve visual design with version badges
- Show version-specific npm package links

### Documentation
- Add comprehensive GitHub Pages setup guide (.github/GITHUB_PAGES.md)
- Update demo README with deployment information
- Update main README with live demo link
- Include troubleshooting and maintenance guides

## Live Demo

https://ibrahimcesar.github.io/react-lite-youtube-embed

The demo automatically updates with each release, ensuring users always
see the latest published version in action.

## Benefits

✅ Automatic deployment on every release
✅ Version synchronization with npm package
✅ Beta/pre-release visual indicators
✅ Zero maintenance after setup
✅ Professional demo showcase
✅ Better user experience for evaluating the component

Closes #XXX (if applicable)
@ibrahimcesar ibrahimcesar merged commit cea0ba8 into main Nov 14, 2025
1 check passed
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.

3 participants