GitHub Star History and Stats - based on JavaScript only, no server side!
Try it now: https://seladb.github.io/StarTrack-js/
- View a GitHub repo star history
- Show stargazer stats such as average number of stars per day, max stars in one day, etc.
- Supports showing multiple repos at the same time (very useful for comparison)
- Display a stargazer forecast based on the existing data
- Provide GitHub authentication (via access token) to overcome GitHub API rate limiter which limits the number of API calls without authentication. The authentication details are stored locally and not sent to any server
- By default they're stored in the browser's session storage
- The user can choose to store them in the browser's local storage for longer persistence
- Preloading repos by URL, for example: https://seladb.github.io/StarTrack-js/#/preload?r=seladb,pickledb-rs will preload
seladb/pickledb-rs
upon loading the page - Download stargazer data to JSON or CSV file
- Enable the option to download stargazer data in JSON or CSV format
- Introduce a warning notification for repositories with an excessive number of stars, indicating limitations imposed by the GitHub API when loading them all
- Introduce dark mode
- Implement better error handling for forecast calculations when recent data is unavailable
- Resolve an issue related to pasting repository GitHub URLs in mobile browsers
- A complete rewrite of the codebase using Typescript and modern React
- Migrated from React Bootstrap to Material UI for a more consistent and polished look
- Upgraded the chart component to Plotly.js for better rendering of large datasets and an improved user experience
- Enhanced the GitHub authentication process to provide a smoother and more user-friendly experience
- Improved the forecast selection process to make it easier for users to choose a desired forecast
- When syncing between the repo stats and the chart, displays the date range of the chart
- Complete test coverage of all components
- Added an option to display a forecast based on the existing stargazer data. The forecast is calculated using Linear Least Squares regression
- Change between username and repo name text boxes using the
/
key (thanks @zaldih !)
- Parallel load of stargazer data which significantly improves the overall loading time (thanks @gsaraf !)
- Display chart data in log scale (thanks @passcod !)
- Added support for smaller screen sizes (mobile devices)
- Small improvements in overall layout
- Added a checkbox to sync the stats with the current chart view displayed. This is useful for viewing stats on specific dates
- You can now paste a GitHub link instead of typing the username and repo name, and they will be parsed automatically
- Added a link to the GitHub repo in the badge displaying the repo details
- Preloading screen: fix decreasing transition in progress bar when loading the next repo
- All React components were replaced from class to function components and are using React Hooks
- A complete rewrite using React and modern frontend technologies
- Significant UI improvements (basically everything looks much better now :-) )
- The chart component has been replaced and it's now easier to navigate, zoom in/out, etc.
- Added an option to remove repos (in version 1.0 you could only add but not remove)
- Added an option to stop loading data
- Each repo has a dedicated color throughout the page (chart series, stats, close button)
- Dedicated preloading screen
- Shows a progress bar for each repo separately
- Shows errors for repos which were not loaded successfully
- GitHub authentication improvements
- When logged in, a new tooltip shows where the access token is stored (browser's session storage or local storage)
- User + password authentication was removed as it's no longer supported by GitHub
This project is built on React and deployed on GitHub Pages. It doesn't have a backend so all of the data is stored locally on the browser and nothing is passed to any server (other than GitHub API to fetch the stargazer data).
It uses the following yarn
packages:
- Material UI for the UI components
- Plotly.js for displaying charts
- Axios for fetching data from GitHub API
- React Router for handling client side routing
- React Testing Library as the testing framework
- Formik for building forms
- React Google Analytics Module
- Moment.js for manipulating date time
- react-responsive for adjusting the UI according to the screen size (desktop vs. mobile)
- react-github-btn for displaying GitHub buttons
- client-zip for downloading data that includes multiple files
Dev packages:
- ESLint, Prettier and their plugins for code linting and formatting
- CSpell for spell check
- Playwright for integration tests
To run it locally follow these steps:
- Clone this repo:
git clone https://github.com/seladb/StarTrack-js.git
- Enter the repo directory:
cd StarTrack-js
- Install the node modules required for this app:
yarn install
- Run it locally:
yarn run start