A modern, responsive web application for viewing and searching PocketMine-MP changelogs. Built for GitHub Pages.
DEVELOPMENT NOTICE: This project is currently under development and has not been officially released. Features may be incomplete or subject to change.
- 📱 Responsive design for desktop and mobile
- 🔍 Advanced search capabilities with filter options
- 📈 Loading progress bar with status updates
- 🔄 Expandable/collapsible version groups
- 📋 Search history
- 🔗 Shareable links via URL parameters
- Browse the version list to find a specific changelog
- Use the search functionality to find specific changes across all versions
- Filter search results for easier navigation
- Use the URL parameters to share specific versions or search results
Visit https://nhanaz.github.io/pmmp-changelog-viewer/ to see the application in action.
A small contribution from Vietnam 🇻🇳 to make PocketMine-MP changelogs more accessible to the community.
Powered by AI tools, including Claude by Anthropic.
Contributions, suggestions, and feedback are always welcome! Feel free to:
- Open an issue if you find a bug or have a feature request
- Submit a pull request to contribute code
- Star the repository if you find it useful
This is a pure static web application designed to be hosted on GitHub Pages. It uses modern JavaScript with modular design.
index.html
- Main HTML filecss/
- CSS stylesheetsjs/
- JavaScript modulesapp.js
- Application entry pointconfig.js
- Configuration variablesutils.js
- Utility functionsstorage.js
- Local storage managementui.js
- UI interactionssearch.js
- Search functionalityversions.js
- Version managementrender.js
- Markdown rendering
changelogs/
- Changelog markdown filesversions.json
- List of available versions
- Clone the repository
- Open the project folder
- Run a local server (or use browser-sync)
- Open in your browser (typically http://localhost:3000)
Using browser-sync (if installed):
npm install
npm start
Security Note: The current version of browser-sync includes a dependency (eazy-logger) with a prototype pollution vulnerability (CVE-2024-57075). This is a development dependency only and doesn't affect the deployed application. Consider using an alternative local server for development if security is a concern.
- Add your markdown changelog file to the
changelogs/
directory - Update
changelogs/versions.json
to include the new file
The repository includes a GitHub Action that automatically updates changelogs from the official PocketMine-MP repository:
- Updates run daily at 00:00 UTC automatically
- Can be manually triggered from the GitHub Actions tab
- Fetches all changelog files from the PocketMine-MP stable branch
- Copies new changelog files to the
changelogs/
directory - Automatically updates the
versions.json
file - Commits and pushes changes if any updates are found
- Automatically deploys to GitHub Pages
The project uses Prettier for code formatting:
- Consistent code style across the project
- Automatically runs on GitHub via GitHub Actions
- Configurable via
.prettierrc
file
To deploy to GitHub Pages:
- Push your changes to the repository
- GitHub Actions will automatically build and deploy to GitHub Pages
- HTML5, CSS3, JavaScript
- Bootstrap 5 for UI components
- Marked.js for Markdown parsing
- highlight.js for code syntax highlighting
- browser-sync for local development
The application supports all modern browsers:
- Chrome (latest)
- Firefox (latest)
- Safari (latest)
- Edge (latest)
This project is licensed under the MIT License - see the LICENSE file for details.