[ { "path": ".deepsource.toml", "content": "version = 1\n\ntest_patterns = [\n \"tests/**\"\n]\n\nexclude_patterns = [\n \"vendor/**\",\n \"*.min.js\"\n]\n\n[[analyzers]]\nname = \"php\"\nenabled = true\n\n [analyzers.meta]\n skip_doc_coverage = [\"class\", \"magic\"]\n\n[[analyzers]]\nname = \"javascript\"\nenabled = true\n" }, { "path": ".devcontainer/Dockerfile", "content": "FROM mcr.microsoft.com/vscode/devcontainers/base:ubuntu-24.04\n\nADD first-run-notice.txt /usr/local/etc/vscode-dev-containers/first-run-notice.txt\n\nRUN apt-get update -y && \\\n apt-get install -y php php-curl php-xml inkscape composer\n" }, { "path": ".devcontainer/devcontainer.json", "content": "{\n \"build\": {\n \"dockerfile\": \"Dockerfile\"\n },\n \"onCreateCommand\": \"/workspaces/github-readme-streak-stats/.devcontainer/on-create.sh\",\n \"postCreateCommand\": \"/workspaces/github-readme-streak-stats/.devcontainer/post-create.sh\"}\n" }, { "path": ".devcontainer/first-run-notice.txt", "content": "👋 Welcome to Codespaces! You are using the pre-configured image.\n\nTests can be executed with: composer test\n" }, { "path": ".devcontainer/on-create.sh", "content": "#!/bin/bash\nset -e\n\ncd /workspaces/github-readme-streak-stats\ncomposer install\n" }, { "path": ".devcontainer/post-create.sh", "content": "#!/bin/bash\nset -e\n\ncd /workspaces/github-readme-streak-stats\nif [ -n \"$GITHUB_TOKEN\" ]; then\n echo \"TOKEN=$GITHUB_TOKEN\" > .env\nfi\n" }, { "path": ".editorconfig", "content": "root = true\n\n[*]\nindent_style = space\nindent_size = 4\nend_of_line = lf\ncharset = utf-8\ntrim_trailing_whitespace = true\ninsert_final_newline = true\n\n[*.md]\ntrim_trailing_whitespace = false\nindent_size = 2\n\n[*.{js,css}]\nindent_size = 2\n" }, { "path": ".gitattributes", "content": "# Auto detect text files and perform LF normalization\n* text=auto eol=lf\n" }, { "path": ".github/FUNDING.yml", "content": "github: [DenverCoder1]\npatreon:\nopen_collective:\nko_fi:\ntidelift:\ncommunity_bridge:\nliberapay:\nissuehunt:\notechie:\ncustom:\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.md", "content": "---\nname: Bug report\nabout: Create a report to help us improve\ntitle: \"\"\nlabels: \"bug\"\nassignees: \"\"\n---\n\n**Describe the bug**\nA clear and concise description of what the bug is.\n\n**To Reproduce**\nSteps to reproduce the behavior:\n\n1. Go to '...'\n2. Click on '....'\n3. Scroll down to '....'\n4. See error\n\n**Expected behavior**\nA clear and concise description of what you expected to happen.\n\n**Screenshots**\nIf applicable, add screenshots to help explain your problem.\n\n**Desktop (please complete the following information):**\n\n- OS: [e.g. iOS]\n- Browser [e.g. chrome, safari]\n- Version [e.g. 22]\n\n**Smartphone (please complete the following information):**\n\n- Device: [e.g. iPhone6]\n- OS: [e.g. iOS8.1]\n- Browser [e.g. stock browser, safari]\n- Version [e.g. 22]\n\n**Additional context**\nAdd any other context about the problem here.\n" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.md", "content": "---\nname: Feature request\nabout: Suggest an idea for this project\ntitle: \"\"\nlabels: \"enhancement\"\nassignees: \"\"\n---\n\n**Is your feature request related to a problem? Please describe.**\nA clear and concise description of what the problem is. Ex. I'm always frustrated when [...]\n\n**Describe the solution you'd like**\nA clear and concise description of what you want to happen.\n\n**Describe alternatives you've considered**\nA clear and concise description of any alternative solutions or features you've considered.\n\n**Additional context**\nAdd any other context or screenshots about the feature request here.\n" }, { "path": ".github/ISSUE_TEMPLATE/question.md", "content": "---\nname: Question\nabout: I have a question about GitHub Streak Stats\ntitle: \"\"\nlabels: \"question\"\nassignees: \"\"\n---\n\n**Description**\n\nA brief description of the question or issue:\n" }, { "path": ".github/ISSUE_TEMPLATE/theme.md", "content": "---\nname: Theme Request\nabout: Request a theme for the project\ntitle: \"\"\nlabels: \"theme\"\nassignees: \"\"\n---\n\n**Describe your theme in detail**\nA clear description about what the theme would entail.\n\n**Include a screenshot / image**\n\n\n\n**Color palette**\nDescribe the colors that could be used with this theme.\n\nAre you going to add the theme?\n\n- [ ] Check for yes\n" }, { "path": ".github/dependabot.yml", "content": "# To get started with Dependabot version updates, you'll need to specify which\n# package ecosystems to update and where the package manifests are located.\n# Please see the documentation for all configuration options:\n# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates\n\nversion: 2\nupdates:\n - package-ecosystem: \"composer\" # See documentation for possible values\n directory: \"/\" # Location of package manifests\n schedule:\n interval: \"daily\"\n" }, { "path": ".github/pull_request_template.md", "content": "## Description\n\n\n\nFixes # \n\n### Type of change\n\n\n\n- [ ] Bug fix (added a non-breaking change which fixes an issue)\n- [ ] New feature (added a non-breaking change which adds functionality)\n- [ ] Updated documentation (updated the readme, templates, or other repo files)\n- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)\n\n## How Has This Been Tested?\n\n\n\n- [ ] Tested locally with a valid username\n- [ ] Tested locally with an invalid username\n- [ ] Ran tests with `composer test`\n- [ ] Added or updated test cases to test new features\n\n## Checklist:\n\n- [ ] I have checked to make sure no other [pull requests](https://github.com/DenverCoder1/github-readme-streak-stats/pulls?q=is%3Apr+sort%3Aupdated-desc+) are open for this issue\n- [ ] The code is properly formatted and is consistent with the existing code style\n- [ ] I have commented my code, particularly in hard-to-understand areas\n- [ ] I have made corresponding changes to the documentation\n- [ ] My changes generate no new warnings\n\n## Screenshots\n\n\n" }, { "path": ".github/workflows/force-release.yml", "content": "name: Manual Release\n\non:\n workflow_dispatch:\n\njobs:\n changelog:\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v3\n\n - name: conventional Changelog Action\n id: changelog\n uses: TriPSs/conventional-changelog-action@v3.7.1\n with:\n github-token: ${{ secrets.CHANGELOG_RELEASE }}\n version-file: './composer.json'\n output-file: 'false'\n skip-on-empty: 'false'\n\n - name: create release\n uses: actions/create-release@v1\n if: ${{ steps.changelog.outputs.skipped == 'false' }}\n env:\n GITHUB_TOKEN: ${{ secrets.CHANGELOG_RELEASE }}\n with:\n tag_name: ${{ steps.changelog.outputs.tag }}\n release_name: ${{ steps.changelog.outputs.tag }}\n body: ${{ steps.changelog.outputs.clean_changelog }}\n" }, { "path": ".github/workflows/phpunit-ci-coverage.yml", "content": "name: PHPUnit CI\n\non:\n workflow_dispatch:\n pull_request:\n push:\n branches:\n - main\n\nenv:\n PHP_VERSION: 8.2\n\njobs:\n build-test:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v3\n - uses: php-actions/composer@v6\n with:\n php_extensions: intl\n php_version: ${{ env.PHP_VERSION }}\n - name: PHPUnit Tests\n uses: php-actions/phpunit@v4\n with:\n php_extensions: intl\n php_version: ${{ env.PHP_VERSION }}\n bootstrap: vendor/autoload.php\n configuration: tests/phpunit/phpunit.xml\n args: --testdox\n env:\n TOKEN: ${{ secrets.GITHUB_TOKEN }}\n" }, { "path": ".github/workflows/prettier.yml", "content": "name: Format with Prettier\n\non:\n push:\n branches:\n - main\n pull_request:\n paths:\n - \"**.php\"\n - \"**.md\"\n - \"**.js\"\n - \"**.css\"\n - \".github/workflows/prettier.yml\"\n\njobs:\n prettier:\n runs-on: ubuntu-latest\n steps:\n - name: Checkout Pull Request\n if: ${{ github.event_name == 'pull_request' }}\n uses: actions/checkout@v3\n with:\n repository: ${{ github.event.pull_request.head.repo.full_name }}\n ref: ${{ github.event.pull_request.head.ref }}\n\n - name: Checkout Push\n if: ${{ github.event_name != 'pull_request' }}\n uses: actions/checkout@v3\n\n - name: Setup Node.js\n uses: actions/setup-node@v3\n with:\n node-version: '22'\n\n - name: Install prettier and plugin-php\n run: npm i\n\n - name: Lint with Prettier\n continue-on-error: true\n run: composer lint\n\n - name: Prettify code\n run: |\n composer lint-fix\n git diff\n\n - name: Commit changes\n uses: EndBug/add-and-commit@v9\n with:\n message: \"style: Formatted code with Prettier\"\n default_author: github_actions\n" }, { "path": ".github/workflows/release.yml", "content": "name: Automated Releases\n\non:\n workflow_dispatch:\n\njobs:\n changelog:\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v3\n\n - name: conventional Changelog Action\n id: changelog\n uses: TriPSs/conventional-changelog-action@v3.7.1\n with:\n github-token: ${{ secrets.CHANGELOG_RELEASE }}\n version-file: './composer.json'\n output-file: 'false'\n\n - name: create release\n uses: actions/create-release@v1\n if: ${{ steps.changelog.outputs.skipped == 'false' }}\n env:\n GITHUB_TOKEN: ${{ secrets.CHANGELOG_RELEASE }}\n with:\n tag_name: ${{ steps.changelog.outputs.tag }}\n release_name: ${{ steps.changelog.outputs.tag }}\n body: ${{ steps.changelog.outputs.clean_changelog }}\n" }, { "path": ".github/workflows/translation-progress.yml", "content": "name: Update Translation Progress\n\non:\n workflow_dispatch:\n push:\n branches:\n - main\n paths:\n - \"src/translations.php\"\n - \"scripts/translation-progress.php\"\n - \".github/workflows/translation-progress.yml\"\n - \"README.md\"\n\nenv:\n PHP_VERSION: 8.2\n\njobs:\n build-test:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v3\n\n - uses: php-actions/composer@v6\n with:\n php_extensions: intl\n php_version: ${{ env.PHP_VERSION }}\n \n - name: Update Translations\n run: php scripts/translation-progress.php\n\n - name: Commit Changes\n uses: EndBug/add-and-commit@v7\n with:\n author_name: GitHub Actions\n author_email: github-actions[bot]@users.noreply.github.com\n message: \"docs(readme): Update translation progress\"\n add: \"README.md\"\n" }, { "path": ".gitignore", "content": "# Generated files\nvendor/\nnode_modules/\n*.log\ncomposer.phar\nyarn.lock\npackage-lock.json\n.vercel\n\n# Cache directory\ncache/\n\n# Local Configuration\n.DS_Store\n\n# Environment\n.env\n.php-version\nDOCKER_ENV\ndocker_tag\n\n# IDE\n.vscode/\n.idea/\n" }, { "path": ".prettierignore", "content": "vendor\n**/*.min.js\n.prettierrc" }, { "path": ".prettierrc.js", "content": "module.exports = {\n printWidth: 120,\n endOfLine: \"auto\",\n plugins: [\"@prettier/plugin-php\"],\n overrides: [\n {\n files: \"*.php\",\n options: {\n parser: \"php\",\n },\n },\n ],\n};\n" }, { "path": "Aptfile", "content": "inkscape\n" }, { "path": "CODE_OF_CONDUCT.md", "content": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as\ncontributors and maintainers pledge to making participation in our project and\nour community a harassment-free experience for everyone, regardless of age, body\nsize, disability, ethnicity, sex characteristics, gender identity and expression,\nlevel of experience, education, socio-economic status, nationality, personal\nappearance, race, religion, or sexual identity and orientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment\ninclude:\n\n- Using welcoming and inclusive language\n- Being respectful of differing viewpoints and experiences\n- Gracefully accepting constructive criticism\n- Focusing on what is best for the community\n- Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include:\n\n- The use of sexualized language or imagery and unwelcome sexual attention or\n advances\n- Trolling, insulting/derogatory comments, and personal or political attacks\n- Public or private harassment\n- Publishing others' private information, such as a physical or electronic\n address, without explicit permission\n- Other conduct which could reasonably be considered inappropriate in a\n professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable\nbehavior and are expected to take appropriate and fair corrective action in\nresponse to any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or\nreject comments, commits, code, wiki edits, issues, and other contributions\nthat are not aligned to this Code of Conduct, or to ban temporarily or\npermanently any contributor for other behaviors that they deem inappropriate,\nthreatening, offensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces\nwhen an individual is representing the project or its community. Examples of\nrepresenting a project or community include using an official project e-mail\naddress, posting via an official social media account, or acting as an appointed\nrepresentative at an online or offline event. Representation of a project may be\nfurther defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be\nreported by contacting me via direct message on Twitter, Reddit, or Discord. All\ncomplaints will be reviewed and investigated and will result in a response that\nis deemed necessary and appropriate to the circumstances. The project team is\nobligated to maintain confidentiality with regard to the reporter of an incident.\nFurther details of specific enforcement policies may be posted separately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good\nfaith may face temporary or permanent repercussions as determined by other\nmembers of the project's leadership.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,\navailable at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html\n\n[homepage]: https://www.contributor-covenant.org\n\nFor answers to common questions about this code of conduct, see\nhttps://www.contributor-covenant.org/faq\n" }, { "path": "CONTRIBUTING.md", "content": "## Contributing Guidelines\n\nContributions are welcome! Feel free to open an issue or submit a pull request if you have a way to improve this project.\n\nMake sure your request is meaningful and you have tested the app locally before submitting a pull request.\n\nThis documentation contains a set of guidelines to help you during the contribution process.\n\n### Need some help regarding the basics?\n\nYou can refer to the following articles on the basics of Git and GitHub in case you are stuck:\n\n- [Forking a Repo](https://help.github.com/en/github/getting-started-with-github/fork-a-repo)\n- [Cloning a Repo](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)\n- [How to create a Pull Request](https://opensource.com/article/19/7/create-pull-request-github)\n- [Getting started with Git and GitHub](https://towardsdatascience.com/getting-started-with-git-and-github-6fcd0f2d4ac6)\n- [Learn GitHub from Scratch](https://github.com/githubtraining/introduction-to-github)\n\n### Installing Requirements\n\n#### Requirements\n\n- [PHP 8.2+](https://www.apachefriends.org/index.html)\n- [Composer](https://getcomposer.org)\n- [Inkscape](https://inkscape.org) (for PNG rendering)\n\n#### Linux\n\n```bash\nsudo apt-get install php\nsudo apt-get install php-curl\nsudo apt-get install composer\nsudo apt-get install inkscape\n```\n\n#### Windows\n\nInstall PHP from [XAMPP](https://www.apachefriends.org/index.html) or [php.net](https://windows.php.net/download)\n\n[▶ How to install and run PHP using XAMPP (Windows)](https://www.youtube.com/watch?v=K-qXW9ymeYQ)\n\n[📥 Download Composer](https://getcomposer.org/download/)\n\n### Clone the repository\n\n```\ngit clone https://github.com/DenverCoder1/github-readme-streak-stats.git\ncd github-readme-streak-stats\n```\n\n### Authorization\n\nTo get the GitHub API to run locally you will need to provide a token.\n\n1. Visit [this link](https://github.com/settings/tokens/new?description=GitHub%20Readme%20Streak%20Stats) to create a new Personal Access Token\n2. Scroll to the bottom and click **\"Generate token\"**\n3. **Make a copy** of the `.env.example` named `.env` in the root directory and add **your token** after `TOKEN=`.\n\n```php\nTOKEN=\n```\n\n### Install dependencies\n\nRun the following command to install all the required dependencies to work on this project.\n\n```bash\ncomposer install\n```\n\n### Running the app locally\n\n```bash\ncomposer start\n```\n\nOpen http://localhost:8000/?user=DenverCoder1 to run the project locally\n\nOpen http://localhost:8000/demo/ to run the demo site\n\n### Running the tests\n\nRun the following command to run the PHPUnit test script which will verify that the tested functionality is still working.\n\n```bash\ncomposer test\n```\n\n## Linting\n\nThis project uses Prettier for formatting PHP, Markdown, JavaScript and CSS files.\n\n```bash\n# Run prettier and show the files that need to be fixed\ncomposer lint\n\n# Run prettier and fix the files\ncomposer lint-fix\n```\n\n## Submitting Contributions 👨‍💻\n\nBelow you will find the process and workflow used to review and merge your changes.\n\n### Step 0 : Find an issue\n\n- Take a look at the existing issues or create your **own** issues!\n\n![issues tab](https://user-images.githubusercontent.com/63443481/136185624-24447858-de8d-4b0a-bb6b-2528d9031196.PNG)\n\n### Step 1 : Fork the Project\n\n- Fork this repository. This will create a copy of this repository on your GitHub profile.\n Keep a reference to the original project in the `upstream` remote.\n\n```bash\ngit clone https://github.com//github-readme-streak-stats.git\ncd github-readme-streak-stats\ngit remote add upstream https://github.com/DenverCoder1/github-readme-streak-stats.git\n```\n\n![fork button](https://user-images.githubusercontent.com/63443481/136185816-0b6770d7-0b00-4951-861a-dd15e3954918.PNG)\n\n- If you have already forked the project, update your copy before working.\n\n```bash\ngit remote update\ngit checkout \ngit rebase upstream/\n```\n\n### Step 2 : Branch\n\nCreate a new branch. Use its name to identify the issue you're addressing.\n\n```bash\n# Creates a new branch with the name feature_name and switches to it\ngit checkout -b feature_name\n```\n\n### Step 3 : Work on the issue assigned\n\n- Work on the issue(s) assigned to you.\n- Make all the necessary changes to the codebase.\n- After you've made changes or made your contribution to the project, add changes to the branch you've just created using:\n\n```bash\n# To add all new files to the branch\ngit add .\n\n# To add only a few files to the branch\ngit add \n```\n\n### Step 4 : Commit\n\n- Commit a descriptive message using:\n\n```bash\n# This message will get associated with all files you have changed\ngit commit -m \"message\"\n```\n\n### Step 5 : Work Remotely\n\n- Now you are ready to your work on the remote repository.\n- When your work is ready and complies with the project conventions, upload your changes to your fork:\n\n```bash\n# To push your work to your remote repository\ngit push -u origin Branch_Name\n```\n\n- Here is how your branch will look.\n\n ![forked branch](https://user-images.githubusercontent.com/63443481/136186235-204f5c7a-1129-44b5-af20-89aa6a68d952.PNG)\n\n### Step 6 : Pull Request\n\n- Go to your forked repository in your browser and click on \"Compare and pull request\". Then add a title and description to your pull request that explains your contribution.\n\n\"compare\n\n\"opening\n\n- Voila! Your Pull Request has been submitted and it's ready to be merged.🥳\n\n#### Happy Contributing!\n" }, { "path": "Dockerfile", "content": "# Use PHP 8.3 (8.4 not supported yet)\nFROM php:8.3-apache@sha256:6be4ef702b2dd05352f7e5fe14667696a4ad091c9d2ad9083becbee4300dc3b1\n\n# Install system dependencies and PHP extensions in one layer\nRUN apt-get update && apt-get install -y --no-install-recommends \\\n git \\\n unzip \\\n libicu-dev \\\n inkscape \\\n fonts-dejavu-core \\\n curl \\\n && docker-php-ext-configure intl \\\n && docker-php-ext-install intl \\\n && apt-get clean \\\n && rm -rf /var/lib/apt/lists/*\n\n# Install Composer\nCOPY --from=composer/composer:latest-bin@sha256:c9bda63056674836406cacfbbdd8ef770fb4692ac419c967034225213c64e11b /composer /usr/bin/composer\n\n# Set working directory\nWORKDIR /var/www/html\n\n# Copy composer files and install dependencies\nCOPY composer.json composer.lock ./\nCOPY src/ ./src/\nRUN composer install --no-dev --optimize-autoloader --no-scripts\n\n# Configure Apache to serve from src/ directory and pass environment variables\nRUN a2enmod rewrite headers && \\\n echo 'ServerTokens Prod\\n\\\n ServerSignature Off\\n\\\n PassEnv TOKEN\\n\\\n PassEnv WHITELIST\\n\\\n \\n\\\n ServerAdmin webmaster@localhost\\n\\\n DocumentRoot /var/www/html/src\\n\\\n \\n\\\n Options -Indexes\\n\\\n AllowOverride None\\n\\\n Require all granted\\n\\\n Header always set Access-Control-Allow-Origin \"*\"\\n\\\n Header always set Content-Type \"image/svg+xml\" \"expr=%{REQUEST_URI} =~ m#\\\\.svg$#i\"\\n\\\n Header always set Content-Security-Policy \"default-src 'none'; style-src 'unsafe-inline'; img-src data:;\" \"expr=%{REQUEST_URI} =~ m#\\\\.svg$#i\"\\n\\\n Header always set Referrer-Policy \"no-referrer-when-downgrade\"\\n\\\n Header always set X-Content-Type-Options \"nosniff\"\\n\\\n \\n\\\n ErrorLog ${APACHE_LOG_DIR}/error.log\\n\\\n CustomLog ${APACHE_LOG_DIR}/access.log combined\\n\\\n ' > /etc/apache2/sites-available/000-default.conf\n\nRUN mkdir -p /var/www/html/cache\n\n# Set secure permissions (cache dir needs write access for www-data)\nRUN chown -R www-data:www-data /var/www/html && \\\n find /var/www/html -type d -exec chmod 755 {} \\; && \\\n find /var/www/html -type f -exec chmod 644 {} \\; && \\\n chmod 775 /var/www/html/cache\n\n# Health check\nHEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \\\n CMD curl -f http://localhost/demo/ || exit 1\n\n# Expose port\nEXPOSE 80\n\n# Start Apache\nCMD [\"apache2-foreground\"]\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2020 Jonah Lawrence\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "Procfile", "content": "web: vendor/bin/heroku-php-apache2 src/\n" }, { "path": "README.md", "content": "

\n \n

Github Readme Streak Stats

\n

\n\n

\n Display your total contributions, current streak,\n
\n and longest streak on your GitHub profile README\n

\n\n

\n \n \n \n \n

\n\n## ⚡ Quick setup\n\n1. Copy-paste the markdown below into your GitHub profile README\n2. Replace the value after `?user=` with your GitHub username\n\n```md\n[![GitHub Streak](https://streak-stats.demolab.com/?user=DenverCoder1)](https://git.io/streak-stats)\n```\n\n3. Star the repo 😄\n\n### Next Steps\n\n- Check out the [Demo Site](https://streak-stats.demolab.com) or [Options](https://github.com/DenverCoder1/github-readme-streak-stats?tab=readme-ov-file#-options) below for available customizations.\n\n- It is recommended to self-host the project more better reliability. See [Deploying it on your own](https://github.com/DenverCoder1/github-readme-streak-stats?tab=readme-ov-file#-deploying-it-on-your-own) for more details.\n\n[![][hspace]](#) [![Deploy to Heroku](https://www.herokucdn.com/deploy/button.svg)][herokudeploy] [![Deploy to Vercel](https://i.imgur.com/Mb3VLCi.png)][verceldeploy]\n\n## ⚙ Demo Site\n\nHere you can customize your Streak Stats card with a live preview.\n\n\n\n[![Demo Site](https://user-images.githubusercontent.com/20955511/114579753-dbac8780-9c86-11eb-97dd-207039f67d20.gif \"Demo Site\")](http://streak-stats.demolab.com/demo/)\n\n## 🔧 Options\n\nThe `user` field is the only required option. All other fields are optional.\n\nIf the `theme` parameter is specified, any color customizations specified will be applied on top of the theme, overriding the theme's values.\n\n| Parameter | Details | Example |\n| :------------------------: | :----------------------------------------------: | :------------------------------------------------------------------------------------------------: |\n| `user` | GitHub username to show stats for | `DenverCoder1` |\n| `theme` | The theme to apply (Default: `default`) | `dark`, `radical`, etc. [🎨➜](./docs/themes.md) |\n| `hide_border` | Make the border transparent (Default: `false`) | `true` or `false` |\n| `border_radius` | Set the roundness of the edges (Default: `4.5`) | Number `0` (sharp corners) to `248` (ellipse) |\n| `background` | Background color (eg. `f2f2f2`, `35,d22,00f`) | **hex code** without `#`, **css color**, or gradient in the form `angle,start_color,...,end_color` |\n| `border` | Border color | **hex code** without `#` or **css color** |\n| `stroke` | Stroke line color between sections | **hex code** without `#` or **css color** |\n| `ring` | Color of the ring around the current streak | **hex code** without `#` or **css color** |\n| `fire` | Color of the fire in the ring | **hex code** without `#` or **css color** |\n| `currStreakNum` | Current streak number | **hex code** without `#` or **css color** |\n| `sideNums` | Total and longest streak numbers | **hex code** without `#` or **css color** |\n| `currStreakLabel` | Current streak label | **hex code** without `#` or **css color** |\n| `sideLabels` | Total and longest streak labels | **hex code** without `#` or **css color** |\n| `dates` | Date range text color | **hex code** without `#` or **css color** |\n| `excludeDaysLabel` | Excluded days of the week text color | **hex code** without `#` or **css color** |\n| `date_format` | Date format pattern or empty for locale format | See note below on [📅 Date Formats](#-date-formats) |\n| `locale` | Locale for labels and numbers (Default: `en`) | ISO 639-1 code - See [🗪 Locales](#-locales) |\n| `short_numbers` | Use short numbers (e.g. 1.5k instead of 1,500) | `true` or `false` |\n| `type` | Output format (Default: `svg`) | Current options: `svg`, `png` or `json` |\n| `mode` | Streak mode (Default: `daily`) | `daily` (contribute daily) or `weekly` (contribute once per Sun-Sat week) |\n| `exclude_days` | List of days of the week to exclude from streaks | Comma-separated list of day abbreviations (Sun, Mon, Tue, Wed, Thu, Fri, Sat) e.g. `Sun,Sat` |\n| `disable_animations` | Disable SVG animations (Default: `false`) | `true` or `false` |\n| `card_width` | Width of the card in pixels (Default: `495`) | Positive integer, minimum width is 100px per column |\n| `card_height` | Height of the card in pixels (Default: `195`) | Positive integer, minimum height is 170px |\n| `hide_total_contributions` | Hide the total contributions (Default: `false`) | `true` or `false` |\n| `hide_current_streak` | Hide the current streak (Default: `false`) | `true` or `false` |\n| `hide_longest_streak` | Hide the longest streak (Default: `false`) | `true` or `false` |\n| `starting_year` | Starting year of contributions | Integer, must be `2005` or later, eg. `2017`. By default, your account creation year is used. |\n\n### 🖌 Themes\n\nTo enable a theme, append `&theme=` followed by the theme name to the end of the source URL:\n\n```md\n[![GitHub Streak](https://streak-stats.demolab.com/?user=DenverCoder1&theme=dark)](https://git.io/streak-stats)\n```\n\n| Theme | Preview |\n| :------------: | :-----------------------------------------------------------: |\n| `default` | ![default](https://i.imgur.com/IaTuYdS.png) |\n| `dark` | ![dark](https://i.imgur.com/bUrsjlp.png) |\n| `highcontrast` | ![highcontrast](https://i.imgur.com/ovrVrTY.png) |\n| More themes! | **🎨 [See a list of all available themes](./docs/themes.md)** |\n\n**If you have come up with a new theme you'd like to share with others, please see [Issue #32](https://github.com/DenverCoder1/github-readme-streak-stats/issues/32) for more information on how to contribute.**\n\n### 🗪 Locales\n\nThe following are the locales that have labels translated in Streak Stats. The `locale` query parameter accepts any ISO language or locale code, see [here](https://gist.github.com/DenverCoder1/f61147ba26bfcf7c3bf605af7d3382d5) for a list of valid locales. The locale provided will be used for the date format and number format even if translations are not yet available.\n\n\n\n\n
en - English
\"English		am - አማርኛ
\"አማርኛ		ar - العربية
\"العربية		as - অসমীয়া
\"অসমীয়া		bho - भोजपुरी
\"भोजपुरी
bn - বাংলা
\"বাংলা		ca - català
\"català		ceb - Cebuano
\"Cebuano		da - dansk
\"dansk		de - Deutsch
\"Deutsch
el - Ελληνικά
\"Ελληνικά		es - español
\"español		fa - فارسی
\"فارسی		fil - Filipino
\"Filipino		fr - français
\"français
gu - ગુજરાતી
\"ગુજરાતી		he - עברית
\"עברית		hi - हिन्दी
\"हिन्दी		hu - magyar
\"magyar		id - Indonesia
\"Indonesia
it - italiano
\"italiano		ja - 日本語
\"日本語		jv - Jawa
\"Jawa		kn - ಕನ್ನಡ
\"ಕನ್ನಡ		ko - 한국어
\"한국어
mai - मैथिली
\"मैथिली		mal - മലയാളം
\"മലയാളം		mi - Māori
\"Māori		mr - मराठी
\"मराठी		ms - Melayu
\"Melayu
ms_ID - Melayu (Indonesia)
\"Melayu		my - မြန်မာ
\"မြန်မာ		ne - नेपाली
\"नेपाली		nl - Nederlands
\"Nederlands		no - norsk
\"norsk
pa - ਪੰਜਾਬੀ
\"ਪੰਜਾਬੀ		pl - polski
\"polski		ps - پښتو
\"پښتو		pt - português
\"português		pt_BR - português (Brasil)
\"português
ro - română
\"română		ru - русский
\"русский		sa - संस्कृत भाषा
\"संस्कृत		sd_PK - سنڌي (پاڪستان)
\"سنڌي		sr_Cyrl - српски (ћирилица)
\"српски
sr_Latn - srpski (latinica)
\"srpski		su - Basa Sunda
\"Basa		sv - svenska
\"svenska		sw - Kiswahili
\"Kiswahili		ta - தமிழ்
\"தமிழ்
tcy - Tulu
\"Tulu		te - తెలుగు
\"తెలుగు		th - ไทย
\"ไทย		tr - Türkçe
\"Türkçe		uk - українська
\"українська
ur_PK - اردو (پاکستان)
\"اردو		vi - Tiếng Việt
\"Tiếng		yo - Èdè Yorùbá
\"Èdè		zh_Hans - 中文（简体）
\"中文（简体）		zh_Hant - 中文（繁體）
\"中文（繁體）
bg - български
\"български		ht - créole haïtien
\"créole		hy - հայերեն
\"հայերեն		rw - Kinyarwanda
\"Kinyarwanda
\n\n\n\n**If you would like to help translate the Streak Stats cards, please see [Issue #236](https://github.com/DenverCoder1/github-readme-streak-stats/issues/236) for more information.**\n\n### 📅 Date Formats\n\nIf `date_format` is not provided or is empty, the PHP Intl library is used to determine the date format based on the locale specified in the `locale` query parameter.\n\nA custom date format can be specified by passing a string to the `date_format` parameter.\n\nThe required format is to use format string characters from [PHP's date function](https://www.php.net/manual/en/datetime.format.php) with brackets around the part representing the year.\n\nWhen the contribution year is equal to the current year, the characters in brackets will be omitted.\n\n**Examples:**\n\n| Date Format | Result |\n| :-----------------: | :-----------------------------------------------------------------------------: |\n| 
d F[, Y]
| 
\"2020-04-14\" => \"14 April, 2020\"

\"2024-04-14\" => \"14 April\"
|\n| 
j/n/Y
| 
\"2020-04-14\" => \"14/4/2020\"

\"2024-04-14\" => \"14/4/2024\"
|\n| 
[Y.]n.j
| 
\"2020-04-14\" => \"2020.4.14\"

\"2024-04-14\" => \"4.14\"
|\n| 
M j[, Y]
| 
\"2020-04-14\" => \"Apr 14, 2020\"

\"2024-04-14\" => \"Apr 14\"
|\n\n### Example\n\n```md\n[![GitHub Streak](https://streak-stats.demolab.com/?user=denvercoder1&currStreakNum=2FD3EB&fire=pink&sideLabels=F00&date_format=[Y.]n.j)](https://git.io/streak-stats)\n```\n\n## ℹ️ How these stats are calculated\n\nThis tool uses the contribution graphs on your GitHub profile to calculate which days you have contributed.\n\nTo include contributions in private repositories, turn on the setting for \"Private contributions\" from the dropdown menu above the contribution graph on your profile page.\n\nContributions include commits, pull requests, and issues that you create in standalone repositories.\n\nThe longest streak is the highest number of consecutive days on which you have made at least one contribution.\n\nThe current streak is the number of consecutive days ending with the current day on which you have made at least one contribution. If you have made a contribution today, it will be counted towards the current streak, however, if you have not made a contribution today, the streak will only count days before today so that your streak will not be zero.\n\n> [!NOTE]\n> You may need to wait up to 24 hours for new contributions to show up ([Learn how contributions are counted](https://docs.github.com/articles/why-are-my-contributions-not-showing-up-on-my-profile))\n\n## 📤 Deploying it on your own\n\nIt is preferable to host the files on your own server and it takes less than 2 minutes to set up.\n\nDoing this can lead to better uptime and more control over customization (you can modify the code for your usage).\n\nYou can deploy the PHP files on any website server with PHP installed including Heroku and Vercel.\n\nThe Inkscape dependency is required for PNG rendering, as well as Segoe UI font for the intended rendering. If using Heroku, the buildpacks will install these for you automatically.\n\n### [![Deploy to Vercel](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/5a503e6b-c462-4627-82ee-651f2cb2a1fc)][verceldeploy]\n\nVercel is the recommended option for hosting the files since it is **free** and easy to set up. Watch the video below or expand the instructions to learn how to deploy to Vercel.\n\n> [!NOTE]\n> PNG mode is not supported since Inkscape will not be installed but the default SVG mode will work.\n\n### 📺 [Click here for a video tutorial on how to self-host on Vercel](https://www.youtube.com/watch?v=maoXtlb8t44)\n\n
\n Instructions for deploying to Vercel (Free)\n\n### Step-by-step instructions for deploying to Vercel\n\n#### Option 1: Deploy to Vercel quickly with the Deploy button (recommended)\n\n> [!IMPORTANT]\n> Make sure that you host the **`vercel`** branch as otherwise you'll get a 404 error from Vercel. You can set the `vercel` branch as default after forking the repo.\n\n1. Click the Deploy button below\n\n[![][hspace]](#) [![Deploy with Vercel](https://i.imgur.com/Mb3VLCi.png)][verceldeploy]\n\n2. Create your repository by filling in a Repository Name and clicking \"Create\"\n3. Visit [this link](https://github.com/settings/tokens/new?description=GitHub%20Readme%20Streak%20Stats) to create a new Personal Access Token (no scopes required)\n4. Scroll to the bottom and click **\"Generate token\"**\n5. **Add the token** as a Config Var with the key `TOKEN`:\n\n![vercel environment variables](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/17a433d6-0aaa-4c69-9a53-6d4638318fbb)\n\n6. Click **\"Deploy\"** at the end of the form\n7. Once the app is deployed, click the screenshot of your app or continue to the dashboard to find your domain to use in place of `streak-stats.demolab.com`\n\n![deployment](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/32092461-5983-4fed-b21b-29be55ed85e8)\n\n> ⚠️ **Note**\n> If you receive an error related to libssl or Node 20.x, you can fix this by opening your Vercel project settings and changing the Node.js version to 18.x.\n>\n> ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/5fb18fb5-debe-4620-9c8b-193ab442a617)\n\n#### Option 2: Deploy to Vercel manually\n\n1. Sign in to **Vercel** or create a new account at \n2. Use the following command to clone the repository: `git clone https://github.com/DenverCoder1/github-readme-streak-stats.git`. If you plan to make changes, you can also fork the repository and clone your fork instead. If you do not have Git installed, you can download it from .\n3. Navigate to the cloned repository's directory using the command `cd github-readme-streak-stats`\n4. Switch to the \"vercel\" branch using the command `git checkout vercel`\n5. Make sure you have the Vercel CLI (Command Line Interface) installed on your system. If not, you can download it from .\n6. Run the command `vercel` and follow the prompts to link your Vercel account and choose a project name\n7. After successful deployment, your app will be available at `.vercel.app`\n8. Open [this link](https://github.com/settings/tokens/new?description=GitHub%20Readme%20Streak%20Stats) to create a new Personal Access Token on GitHub. You don't need to select any scopes for the token.\n9. Scroll to the bottom of the page and click on **\"Generate token\"**\n10. Visit the Vercel dashboard at and select your project. Then, click on **\"Settings\"** and choose **\"Environment Variables\"**.\n11. Add a new environment variable with the key `TOKEN` and the value as the token you generated in step 9, then save your changes\n12. (Optional) You can also set the `WHITELIST` environment variable to restrict which GitHub usernames can be accessed through the service. Provide the usernames as a comma-separated list, for example: `user1,user2,user3`. If the variable is not set, information can be requested for any GitHub user.\n13. To apply the new environment variable(s), you need to redeploy the app. Run `vercel --prod` to deploy the app to production.\n\n![image](https://user-images.githubusercontent.com/20955511/209588756-8bf5b0cd-9aa6-41e8-909c-97bf41e525b3.png)\n\n> ⚠️ **Note**\n> To set up automatic Vercel deployments from GitHub, make sure to turn **off** \"Include source files outside of the Root Directory\" in the General settings and use `vercel` as the production branch in the Git settings.\n\n> ⚠️ **Note**\n> If you receive an error related to libssl or Node 20.x, you can fix this by opening your Vercel project settings and changing the Node.js version to 18.x.\n>\n> ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/5fb18fb5-debe-4620-9c8b-193ab442a617)\n\n
\n\n### [![Deploy on Heroku](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/e8b575af-5746-4200-a295-7e7baa448383)][herokudeploy]\n\nHeroku is another great option for hosting the files. All features are supported on Heroku and it is where the default domain is hosted. Heroku is not free, however, and you will need to pay between \\$5 and \\$7 per month to keep the app running. Expand the instructions below to learn how to deploy to Heroku.\n\n
\n Instructions for deploying to Heroku (Paid)\n\n### Step-by-step instructions for deploying to Heroku\n\n1. Sign in to **Heroku** or create a new account at \n2. Visit [this link](https://github.com/settings/tokens/new?description=GitHub%20Readme%20Streak%20Stats) to create a new Personal Access Token (no scopes required)\n3. Scroll to the bottom and click **\"Generate token\"**\n4. Click the Deploy button below\n\n[![][hspace]](#) [![Deploy to Heroku](https://www.herokucdn.com/deploy/button.svg)][herokudeploy]\n\n5. **Add the token** as a Config Var with the key `TOKEN`:\n\n![heroku config variables](https://user-images.githubusercontent.com/20955511/136292022-a8d9b3b5-d7d8-4a5e-a049-8d23b51ce9d7.png)\n\n6. (Optional) You can also set the `WHITELIST` Config Var to restrict which GitHub usernames can be accessed through the service. Provide the usernames as a comma-separated list, for example: `user1,user2,user3`. If the variable is not set, information can be requested for any GitHub user.\n7. Click **\"Deploy App\"** at the end of the form\n8. Once the app is deployed, you can use `.herokuapp.com` in place of `streak-stats.demolab.com`\n\n
\n\n### ![Deploy on your own](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/e36ed842-ab56-473a-83fd-ace5bf968996)\n\nYou can transfer the files to any webserver using FTP or other means, then refer to [CONTRIBUTING.md](/CONTRIBUTING.md) for installation steps.\n\n### 🐳 Docker\n\nDocker is a great option for self-hosting with full control over your environment. All features are supported including PNG rendering with Inkscape. Expand the instructions below to learn how to deploy with Docker.\n\n
\n Instructions for deploying with Docker\n\n### Step-by-step instructions for deploying with Docker\n\n1. Clone the repository:\n\n ```bash\n git clone https://github.com/DenverCoder1/github-readme-streak-stats.git\n cd github-readme-streak-stats\n ```\n\n2. Visit https://github.com/settings/tokens/new?description=GitHub%20Readme%20Streak%20Stats to create a new Personal Access Token (no scopes required)\n\n3. Scroll to the bottom and click \"Generate token\"\n\n4. Build the Docker image:\n\n ```bash\n docker build -t streak-stats .\n ```\n\n5. Run the container with your GitHub token:\n\n ```bash\n docker run -d -p 8080:80 -e TOKEN=your_github_token_here streak-stats\n ```\n\n6. You can also optionally set the `WHITELIST` environment variable to restrict which GitHub usernames can be accessed through the service. If the `WHITELIST` variable is not set, information can be requested for any GitHub user.\n Provide the usernames as a comma-separated list, for example:\n\n ```bash\n docker run -d -p 8080:80 -e TOKEN=your_github_token_here -e WHITELIST=user1,user2,user3 streak-stats\n ```\n\n7. Visit http://localhost:8080 to access your self-hosted instance\n\n
\n\n[hspace]: https://user-images.githubusercontent.com/20955511/136058102-b79570bc-4912-4369-b664-064a0ada8588.png\n[verceldeploy]: https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FDenverCoder1%2Fgithub-readme-streak-stats%2Ftree%2Fvercel&env=TOKEN&envDescription=GitHub%20Personal%20Access%20Token%20(no%20scopes%20required)&envLink=https%3A%2F%2Fgithub.com%2Fsettings%2Ftokens%2Fnew%3Fdescription%3DGitHub%2520Readme%2520Streak%2520Stats&project-name=streak-stats&repository-name=github-readme-streak-stats\n[herokudeploy]: https://heroku.com/deploy?template=https://github.com/DenverCoder1/github-readme-streak-stats/tree/main\n\n## 🤗 Contributing\n\nContributions are welcome! Feel free to [open an issue](https://github.com/DenverCoder1/github-readme-streak-stats/issues/new/choose) or submit a [pull request](https://github.com/DenverCoder1/github-readme-streak-stats/compare) if you have a way to improve this project.\n\nMake sure your request is meaningful and you have tested the app locally before submitting a pull request.\n\nRefer to [CONTRIBUTING.md](/CONTRIBUTING.md) for more details on contributing, installing requirements, and running the application.\n\n## 🙋‍♂️ Support\n\n💙 If you like this project, give it a ⭐ and share it with friends!\n\n

\n \"Youtube\"\n \"Sponsor\n

\n\n[☕ Buy me a coffee](https://ko-fi.com/jlawrence)\n\n---\n\nMade with ❤️ and PHP\n\n\"Powered\n" }, { "path": "app.json", "content": "{\n \"name\": \"GitHub Readme Streak Stats\",\n \"description\": \"🔥 Stay motivated and show off your contribution streak! 🌟 Display your total contributions, current streak, and longest streak on your GitHub profile README.\",\n \"repository\": \"https://github.com/DenverCoder1/github-readme-streak-stats/\",\n \"logo\": \"https://i.imgur.com/Z4bDOxC.png\",\n \"keywords\": [\"github\", \"dynamic\", \"readme\", \"contributions\", \"streak\", \"stats\"],\n \"addons\": [],\n \"env\": {\n \"TOKEN\": {\n \"description\": \"GitHub personal access token obtained from https://github.com/settings/tokens/new\",\n \"required\": true\n }\n },\n \"formation\": {\n \"web\": {\n \"quantity\": 1,\n \"size\": \"basic\"\n }\n },\n \"buildpacks\": [\n {\n \"url\": \"https://github.com/heroku/heroku-buildpack-apt\"\n },\n {\n \"url\": \"https://github.com/DenverCoder1/heroku-buildpack-fonts-segoe-ui\"\n },\n {\n \"url\": \"heroku/php\"\n }\n ]\n}\n" }, { "path": "composer.json", "content": "{\n \"name\": \"denvercoder1/github-readme-streak-stats\",\n \"description\": \"🔥 Stay motivated and show off your contribution streak! 🌟 Display your total contributions, current streak, and longest streak on your GitHub profile README.\",\n \"keywords\": [\n \"github\",\n \"dynamic\",\n \"readme\",\n \"contributions\",\n \"streak\",\n \"stats\"\n ],\n \"license\": \"MIT\",\n \"version\": \"1.6.0\",\n \"homepage\": \"https://github.com/DenverCoder1/github-readme-streak-stats\",\n \"repositories\": [\n {\n \"type\": \"vcs\",\n \"url\": \"https://github.com/DenverCoder1/github-readme-streak-stats\"\n }\n ],\n \"support\": {\n \"issues\": \"https://github.com/DenverCoder1/github-readme-streak-stats/issues\",\n \"source\": \"https://github.com/DenverCoder1/github-readme-streak-stats\"\n },\n \"autoload\": {\n \"classmap\": [\n \"src/\"\n ]\n },\n \"require\": {\n \"php\": \"^8.2\",\n \"ext-intl\": \"*\",\n \"vlucas/phpdotenv\": \"^5.3\"\n },\n \"require-dev\": {\n \"phpunit/phpunit\": \"^11\"\n },\n \"scripts\": {\n \"start\": [\n \"Composer\\\\Config::disableProcessTimeout\",\n \"php -S localhost:8000 -t src\"\n ],\n \"test\": \"./vendor/bin/phpunit --testdox tests\",\n \"lint\": \"npx prettier --check *.md **/*.{php,md,js,css}\",\n \"lint-fix\": \"npx prettier --write *.md **/*.{php,md,js,css}\"\n }\n}\n" }, { "path": "docs/faq.md", "content": "# FAQ\n\n## How do I create a Readme for my profile?\n\nA profile readme appears on your profile page when you create a repository with the same name as your username and add a `README.md` file to it. For example, the repository for the user [`DenverCoder1`](https://github.com/DenverCoder1) is located at [`DenverCoder1/DenverCoder1`](https://github.com/DenverCoder1/DenverCoder1).\n\n## How do I include GitHub Readme Streak Stats in my Readme?\n\nMarkdown files on GitHub support embedded images using Markdown or HTML. You can customize your Streak Stats image on the [demo site](https://streak-stats.demolab.com/demo/) and use the image source in either of the following ways:\n\n### Markdown\n\n```md\n[![GitHub Streak](https://streak-stats.demolab.com?user=DenverCoder1)](https://git.io/streak-stats)\n```\n\n### HTML\n\n\n```html\n\n```\n\n\n## Why doesn't my Streak Stats match my contribution graph?\n\nGitHub Readme Streak Stats uses the GitHub API to fetch your contribution data. These stats are returned in UTC time which may not match your local time. Additionally, due to caching, the stats may not be updated immediately after a commit. You may need to wait up to a few hours to see the latest stats.\n\nIf you think your stats are not showing up because of a time zone issue, you can try one of the following:\n\n1. Change the date of the commit. You can [adjust the time](https://codewithhugo.com/change-the-date-of-a-git-commit/) of a past commit to make it in the middle of the day.\n2. Create a new commit in a repository with the date set to the date that is missing from your streak stats:\n\n```bash\ngit commit --date=\"2022-08-02 12:00\" -m \"Test commit\" --allow-empty\ngit push\n```\n\n## What is considered a \"contribution\"?\n\nContributions include commits, pull requests, and issues that you create in standalone repositories ([Learn more about what is considered a contribution](https://docs.github.com/articles/why-are-my-contributions-not-showing-up-on-my-profile)).\n\nThe longest streak is the highest number of consecutive days on which you have made at least one contribution.\n\nThe current streak is the number of consecutive days ending with the current day on which you have made at least one contribution. If you have made a contribution today, it will be counted towards the current streak, however, if you have not made a contribution today, the streak will only count days before today so that your streak will not be zero.\n\n> Note: You may need to wait up to 24 hours for new contributions to show up ([Learn how contributions are counted](https://docs.github.com/articles/why-are-my-contributions-not-showing-up-on-my-profile))\n\n## How do I enable private contributions?\n\nTo include contributions in private repositories, turn on the setting for \"Private contributions\" from the dropdown menu above the contribution graph on your profile page.\n\n## How do I center the image on the page?\n\nTo center align images, you must use the HTML syntax and wrap it in an element with the HTML attribute `align=\"center\"`.\n\n\n```html\n

\n \n

\n```\n\n\n## How do I make different images for dark mode and light mode?\n\nYou can [specify theme context](https://github.blog/changelog/2022-05-19-specify-theme-context-for-images-in-markdown-beta/) using the `` and `` elements as shown below. The dark mode version appears in the `srcset` of the `` tag and the light mode version appears in the `src` of the `` tag.\n\n\n```html\n\n \n \n\n```\n\n\n## Why and how do I self-host GitHub Readme Streak Stats?\n\nSelf-hosting the code can be done online and only takes a couple minutes. The benefits include better uptime since it will use your own access token so will not run into ratelimiting issues and it allows you to customize the deployment for your own use case.\n\n### [📺 Click here for a video tutorial on how to self-host on Vercel](https://www.youtube.com/watch?v=maoXtlb8t44)\n\nSee [Deploying it on your own](https://github.com/DenverCoder1/github-readme-streak-stats?tab=readme-ov-file#-deploying-it-on-your-own) in the Readme for detailed instructions.\n" }, { "path": "docs/themes.md", "content": "## Currently supported themes\n\nTo enable a theme, append `&theme=` followed by the theme name to the end of your url.\n\nYou can also try out and customize these themes on the [Demo Site](https://streak-stats.demolab.com/demo/)!\n\nNote: Theme names provided are case-insensitive and any use of underscores will be treated the same as hyphens.\n\n| Theme | Preview |\n| :---------------------------: | :------------------------------------------------------------------------------------------------------------------------: |\n| `default` | ![image](https://user-images.githubusercontent.com/107488620/183304039-a1fcf05c-0112-493a-9188-778708dc9e8f.png) |\n| `dark` | ![image](https://user-images.githubusercontent.com/107488620/183304038-2788ab5d-4c02-45e9-a724-990f27061c54.png) |\n| `highcontrast` | ![image](https://user-images.githubusercontent.com/107488620/183304037-0e54b5e6-f39a-481d-806f-3369d257a391.png) |\n| `transparent` | ![image](https://user-images.githubusercontent.com/20955511/221571948-1b69a2cc-87af-4e96-83fa-f01278c22c33.png) |\n| `radical` | ![image](https://user-images.githubusercontent.com/20955511/183303809-eb8fea2f-d56b-4ad3-9f6d-ef55f8812ed2.png) |\n| `merko` | ![image](https://user-images.githubusercontent.com/20955511/183303806-4ce9e5bb-6bd7-4914-a4ff-47edee01bde3.png) |\n| `gruvbox` | ![image](https://user-images.githubusercontent.com/20955511/183303804-95ff960f-ad52-4026-8627-a67f1599cee3.png) |\n| `gruvbox-duo` | ![image](https://user-images.githubusercontent.com/20955511/183303801-eb1d8dea-7f89-4075-b334-542bb546dfcd.png) |\n| `tokyonight` | ![image](https://user-images.githubusercontent.com/20955511/183303799-e039b635-5424-437b-9f87-7ed9dca8aea6.png) |\n| `tokyonight-duo` | ![image](https://user-images.githubusercontent.com/20955511/183303796-03bb6eb2-667f-492b-8397-efd2ad93edeb.png) |\n| `onedark` | ![image](https://user-images.githubusercontent.com/20955511/183303794-54389af4-24f3-41e6-9d70-2e949d19227e.png) |\n| `onedark-duo` | ![image](https://user-images.githubusercontent.com/20955511/183303791-a4a6d5f0-ab3a-4f6e-b4cc-a87bb24fd135.png) |\n| `cobalt` | ![image](https://user-images.githubusercontent.com/20955511/183303787-eaa77366-6f13-4dc8-a0fa-637ac5333612.png) |\n| `synthwave` | ![image](https://user-images.githubusercontent.com/20955511/183303784-6257055f-d206-4d1a-bdb9-95e9dd7052fb.png) |\n| `dracula` | ![image](https://user-images.githubusercontent.com/20955511/183303782-2231d9eb-9b65-4cf9-9e26-f4cfb773abf6.png) |\n| `prussian` | ![image](https://user-images.githubusercontent.com/20955511/183303779-56649d30-2226-4797-b001-0ca1c3902132.png) |\n| `monokai` | ![image](https://user-images.githubusercontent.com/20955511/183303777-5f424f42-3c71-4802-946d-148dd4a0805f.png) |\n| `vue` | ![image](https://user-images.githubusercontent.com/20955511/183303773-44ea348d-973b-4d3c-967c-7152bba274d5.png) |\n| `vue-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303769-0735cf9f-d44c-40ca-b2c1-2b56384670b4.png) |\n| `shades-of-purple` | ![image](https://user-images.githubusercontent.com/20955511/183303767-30426d56-e2bd-487a-98d7-7e5f5c8eb640.png) |\n| `nightowl` | ![image](https://user-images.githubusercontent.com/20955511/183303763-289d7a24-070f-4604-b729-8dd75eefe234.png) |\n| `buefy` | ![image](https://user-images.githubusercontent.com/20955511/183303761-3e0d060a-6a67-407a-9a0a-9c1e615cff87.png) |\n| `buefy-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303760-df6fcc74-884a-404b-9966-34363a7438b3.png) |\n| `blue-green` | ![image](https://user-images.githubusercontent.com/20955511/183303758-c8c90e09-db0d-4179-a91f-6463489fee7e.png) |\n| `algolia` | ![image](https://user-images.githubusercontent.com/20955511/183303756-2b0134af-ab8b-42d4-b805-4e853f929c5e.png) |\n| `great-gatsby` | ![image](https://user-images.githubusercontent.com/20955511/183303754-168e88f6-80db-443b-b91b-2086b164531b.png) |\n| `darcula` | ![image](https://user-images.githubusercontent.com/20955511/183303753-4b91b591-4502-4a39-9554-8ed2c7eb9777.png) |\n| `bear` | ![image](https://user-images.githubusercontent.com/20955511/183303752-5adcd734-3cdb-44f7-8c67-e42edde5ac9c.png) |\n| `solarized-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303751-b1570958-bb9a-4829-9588-0d94c3fb5cfe.png) |\n| `solarized-light` | ![image](https://user-images.githubusercontent.com/20955511/183303750-03e52dfd-b052-4acd-aee6-78a1106c147e.png) |\n| `chartreuse-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303749-1a489c0e-7a53-4fd5-90cd-b1271aca26e3.png) |\n| `nord` | ![image](https://user-images.githubusercontent.com/20955511/183303748-556b28e8-2f87-4657-b164-899f3216ef51.png) |\n| `gotham` | ![image](https://user-images.githubusercontent.com/20955511/183303747-bf39ce32-1bdf-4712-b4fd-abd0eb54a89e.png) |\n| `material-palenight` | ![image](https://user-images.githubusercontent.com/20955511/183303746-e73933e0-03fa-480d-9469-296852be957a.png) |\n| `graywhite` | ![image](https://user-images.githubusercontent.com/20955511/183303745-185ba0c3-a840-4a4e-95e3-03325c3b3e4e.png) |\n| `vision-friendly-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303743-0c134e67-aa99-43cb-9a56-3a8b6c9fe44a.png) |\n| `ayu-mirage` | ![image](https://user-images.githubusercontent.com/20955511/183303742-31e46a33-fb80-4cf4-a966-d751d98a9c93.png) |\n| `midnight-purple` | ![image](https://user-images.githubusercontent.com/20955511/183303740-641a4a18-da69-46a8-b218-f1a6dc04fcdf.png) |\n| `calm` | ![image](https://user-images.githubusercontent.com/20955511/183303737-c00375f6-e2bc-4cf5-99c2-1544366fd260.png) |\n| `flag-india` | ![image](https://user-images.githubusercontent.com/20955511/183303735-66e35638-0fa3-40f4-b9aa-9b6c284eac8f.png) |\n| `omni` | ![image](https://user-images.githubusercontent.com/20955511/183303734-67e9f9d1-82e5-4518-8105-9105c8a13e6b.png) |\n| `react` | ![image](https://user-images.githubusercontent.com/20955511/183303733-0d994b10-1fb3-497a-8c8c-7d901dda03ed.png) |\n| `jolly` | ![image](https://user-images.githubusercontent.com/20955511/183303732-2e877a4e-f609-452d-b091-d5fb48482def.png) |\n| `maroongold` | ![image](https://user-images.githubusercontent.com/20955511/183303731-08ca9109-551d-4052-a17f-630cbb0cf323.png) |\n| `yeblu` | ![image](https://user-images.githubusercontent.com/20955511/183303730-5ffad264-362d-4ee6-82b2-15b8a8669462.png) |\n| `blueberry` | ![image](https://user-images.githubusercontent.com/20955511/183303729-f3c89ba7-efef-437e-9a05-fa5feebb9d72.png) |\n| `blueberry-duo` | ![image](https://user-images.githubusercontent.com/20955511/183303728-4d209b8c-536f-4921-aa43-6371f1e313fe.png) |\n| `slateorange` | ![image](https://user-images.githubusercontent.com/20955511/183303727-7ffec3ef-1303-4096-bd0f-f8fc1e4949e6.png) |\n| `kacho-ga` | ![image](https://user-images.githubusercontent.com/20955511/183303726-9adaaf73-2ea8-4b78-a3f4-7382ce299511.png) |\n| `ads-juicy-fresh` | ![image](https://user-images.githubusercontent.com/20955511/183303725-25851d72-963a-4532-a5ca-1eaae6c4c224.png) |\n| `black-ice` | ![image](https://user-images.githubusercontent.com/20955511/183303724-de45e18a-d4f8-48ae-88c1-d54a35d2ecea.png) |\n| `soft-green` | ![image](https://user-images.githubusercontent.com/20955511/183303722-3ae70df8-87ff-4b3b-a941-f84cef5dddf4.png) |\n| `blood` | ![image](https://user-images.githubusercontent.com/20955511/183303721-a22ea310-ebab-4ef5-bab9-2f1d7e7c566d.png) |\n| `blood-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303720-487819af-3c20-4854-8ae1-85d70115cf80.png) |\n| `green-nur` | ![image](https://user-images.githubusercontent.com/20955511/183303719-dc5ad223-cdd6-4830-9ffb-0ae965ec0159.png) |\n| `neon-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303718-8b043f5f-8d87-4370-ac42-38032e230d6e.png) |\n| `neon-palenight` | ![image](https://user-images.githubusercontent.com/20955511/183303716-bf924275-320f-44b6-8ad7-6a5f786ee9e6.png) |\n| `dark-smoky` | ![image](https://user-images.githubusercontent.com/20955511/183303715-baad8600-943a-4ad6-85d9-f7c2a46eab41.png) |\n| `monokai-metallian` | ![image](https://user-images.githubusercontent.com/20955511/183303713-2bf8ee11-a251-4d39-8aa5-ed1fd4c545ce.png) |\n| `city-lights` | ![image](https://user-images.githubusercontent.com/20955511/183303712-c9aa7429-eece-4d03-8c10-fbf28c77d495.png) |\n| `blux` | ![image](https://user-images.githubusercontent.com/20955511/183303711-ed60bb0e-9392-468b-a344-22debb20613a.png) |\n| `earth` | ![image](https://user-images.githubusercontent.com/20955511/183303710-b3c336ad-df6d-4529-aa95-6808bfe907dc.png) |\n| `deepblue` | ![image](https://user-images.githubusercontent.com/20955511/183303709-823b626b-d9c6-4e12-a146-e641a0345a2f.png) |\n| `holi-theme` | ![image](https://user-images.githubusercontent.com/20955511/183303708-83f5f757-5692-4e24-8e66-daaa8bca6b5b.png) |\n| `ayu-light` | ![image](https://user-images.githubusercontent.com/20955511/183303707-fb381b09-9963-48c8-90b9-f6b5bc67c85a.png) |\n| `javascript` | ![image](https://user-images.githubusercontent.com/20955511/183303706-4b4e34ef-6d43-4255-9a58-1d35c3127ff7.png) |\n| `javascript-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303704-65313140-d66a-4f9b-9ce6-da176ecd6ec7.png) |\n| `noctis-minimus` | ![image](https://user-images.githubusercontent.com/20955511/183303703-3f774a1e-573c-48a3-a7cd-1f226784d74f.png) |\n| `github-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303702-1bd5adbb-7277-4610-ad59-e5bdf20dd1de.png) |\n| `github-dark-blue` | ![image](https://user-images.githubusercontent.com/20955511/183303701-34bf6b33-812d-4afd-9c1f-70b04b2e486a.png) |\n| `github-light` | ![image](https://user-images.githubusercontent.com/20955511/183303700-7678833c-70c1-4260-8da0-5c8db7b2c38b.png) |\n| `elegant` | ![image](https://user-images.githubusercontent.com/20955511/183303699-fdd92594-83ca-486f-9ed4-a555f674d59a.png) |\n| `leafy` | ![image](https://user-images.githubusercontent.com/20955511/183303696-5129d744-af63-4874-bc99-d603ffb03b2e.png) |\n| `navy-gear` | ![image](https://user-images.githubusercontent.com/20955511/183303695-633ba0b8-11c0-49f3-988d-49390862696a.png) |\n| `hacker` | ![image](https://user-images.githubusercontent.com/20955511/183303694-e5cd3ee9-2158-41ed-8ad6-20ca7f1298cf.png) |\n| `garden` | ![image](https://user-images.githubusercontent.com/20955511/183303692-ea99a78d-be75-43fa-80ca-83f3ae454a35.png) |\n| `github-green-purple` | ![image](https://user-images.githubusercontent.com/20955511/183303691-278ec85a-197d-4a6b-abf3-593e4cc8492b.png) |\n| `icegray` | ![image](https://user-images.githubusercontent.com/20955511/183303690-7d798870-dd80-4d71-b5c2-775cc3555e14.png) |\n| `neon-blurange` | ![image](https://user-images.githubusercontent.com/20955511/183303688-7a4ceb50-84e8-47ca-8cf0-14f212227ce6.png) |\n| `yellowdark` | ![image](https://user-images.githubusercontent.com/20955511/183303687-49da2ffe-5fc9-4a0b-9ca9-c46bc394ec03.png) |\n| `java-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303686-a652b2fb-daae-4390-b245-71610aa54ef7.png) |\n| `android-dark` | ![image](https://user-images.githubusercontent.com/20955511/183303685-fed30ead-2660-48bc-b724-04fe3c394c7f.png) |\n| `deuteranopia-friendly-theme` | ![image](https://user-images.githubusercontent.com/107488620/183304765-9d423ff4-52ed-4a27-8a1c-2bcd290f4803.png) |\n| `windows-dark` | ![image](https://user-images.githubusercontent.com/103951737/183449796-23096f23-54b5-45af-8078-b8afd4f3baf3.png) |\n| `git-dark` | ![image](https://user-images.githubusercontent.com/103951737/183690748-060943ff-7b39-4229-b32d-806d654bd12d.png) |\n| `python-dark` | ![image](https://user-images.githubusercontent.com/103951737/183929763-ae8c93d4-0106-461c-bded-2c2adb0bd6bf.png) |\n| `sea` | ![image](https://user-images.githubusercontent.com/103951737/184303266-0e5f8a25-bfeb-4876-abf1-91a38ca87680.png) |\n| `sea-dark` | ![image](https://user-images.githubusercontent.com/103951737/184301879-953370eb-e61a-4e0f-abf4-7029c336e8f1.png) |\n| `violet-dark` | ![image](https://user-images.githubusercontent.com/103951737/184529784-05de7e57-b939-42f7-9852-345fa191c343.png) |\n| `horizon` | ![image](https://user-images.githubusercontent.com/3828247/184559656-e1f1b290-0a44-45cc-9681-010577386760.png) |\n| `material` | ![image](https://user-images.githubusercontent.com/20955511/193617994-dfab039d-b111-4a95-a00d-39517d9e40ab.png) |\n| `modern-lilac` | ![image](https://user-images.githubusercontent.com/20955511/197569406-6ff144c3-1d6e-4500-9f0b-3112a6c62584.png) |\n| `modern-lilac2` | ![image](https://user-images.githubusercontent.com/20955511/197575977-029fc730-9c7e-4556-be7c-a727a1715fa7.png) |\n| `halloween` | ![image](https://user-images.githubusercontent.com/20955511/198897937-a3c918ea-0f35-43a0-9faf-80ad8f254cdf.png) |\n| `violet-punch` | ![image](https://user-images.githubusercontent.com/20955511/199313653-d678d969-facd-4f8d-b36e-2d0ee2ce61a5.png) |\n| `submarine-flowers` | ![image](https://user-images.githubusercontent.com/20955511/201519290-14d69c90-ce17-4c63-9020-7b244ebc6fab.png) |\n| `rising-sun` | ![image](https://user-images.githubusercontent.com/20955511/221126697-2c47639d-23c5-4c23-b545-d883063deebf.png) |\n| `gruvbox-light` | ![image](https://user-images.githubusercontent.com/20955511/221585454-f9474df6-bbf4-4e3a-91e4-5e9e090e90c0.png) |\n| `outrun` | ![image](https://user-images.githubusercontent.com/20955511/221585435-d39df945-6387-4e3e-abdf-0af7dd0dabef.png) |\n| `ocean-dark` | ![image](https://user-images.githubusercontent.com/20955511/221585476-3eb2d25c-346b-4562-808e-bf09a59b17cd.png) |\n| `discord-old-blurple` | ![image](https://user-images.githubusercontent.com/20955511/221585526-e191cb4c-9957-4ec9-85ec-8916ac691b40.png) |\n| `aura-dark` | ![image](https://user-images.githubusercontent.com/20955511/221585541-88c2a657-dbe7-47a2-b6f9-9e3cdf1fbbfe.png) |\n| `panda` | ![image](https://user-images.githubusercontent.com/20955511/221585562-1f7edc63-41c7-43c6-ac33-fd0ecb32ec5f.png) |\n| `cobalt2` | ![image](https://user-images.githubusercontent.com/20955511/221585614-256d590d-9c45-43a8-be15-48231e418bf2.png) |\n| `swift` | ![image](https://user-images.githubusercontent.com/20955511/221585640-666641b9-cc29-435c-948f-f50e58a6b330.png) |\n| `aura` | ![image](https://user-images.githubusercontent.com/20955511/221585659-f4e8a547-7f98-4438-aba9-8f13ffbcc657.png) |\n| `apprentice` | ![image](https://user-images.githubusercontent.com/20955511/221585690-155c5b01-988e-4e1c-a588-94edb0913800.png) |\n| `moltack` | ![image](https://user-images.githubusercontent.com/20955511/221585716-9e9a9bb6-17cf-458d-826c-1d9a659cdcec.png) |\n| `codestackr` | ![image](https://user-images.githubusercontent.com/20955511/221585743-c836e303-9b9a-4caf-bd12-ef83bf39bf54.png) |\n| `rose-pine` | ![image](https://user-images.githubusercontent.com/20955511/221585761-b7df70e8-b2c4-446a-a6fc-4fd13aa18117.png) |\n| `date-night` | ![image](https://user-images.githubusercontent.com/20955511/221585779-db7f394d-b3c6-49e4-ad75-bbba97530765.png) |\n| `one-dark-pro` | ![image](https://user-images.githubusercontent.com/20955511/221585805-1d10928a-286c-4945-95ed-a7317e56692f.png) |\n| `rose` | ![image](https://user-images.githubusercontent.com/20955511/221585827-e566b73a-e0c0-4711-b48c-667e6500d44e.png) |\n| `neon` | ![image](https://user-images.githubusercontent.com/20955511/225303106-8c901c48-732e-49ae-a2e6-8733254536eb.png) |\n| `sunset-gradient` | ![image](https://user-images.githubusercontent.com/20955511/233865257-3ed2bd35-458b-46bc-a189-57b0c8a2a473.png) |\n| `ocean-gradient` | ![image](https://user-images.githubusercontent.com/20955511/233865264-3bb6c04d-05d2-47b1-857c-3f9a1277651f.png) |\n| `ambient-gradient` | ![image](https://user-images.githubusercontent.com/20955511/233865269-81583e73-c9b6-4e4b-9475-bc130de1bfdd.png) |\n| `catppuccin-latte` | ![image](https://user-images.githubusercontent.com/85760664/248204601-358a8a31-4ffc-4535-a617-840926ecd4f0.png) |\n| `catppuccin-frappe` | ![image](https://user-images.githubusercontent.com/85760664/248204858-daa7bd60-1e83-4b4e-8afc-65644055235e.png) |\n| `catppuccin-macchiato` | ![image](https://user-images.githubusercontent.com/85760664/248205012-15d74ba2-746a-4efd-b2f5-bc2db87b7c10.png) |\n| `catppuccin-mocha` | ![image](https://user-images.githubusercontent.com/85760664/248204228-9f965d12-2013-48c9-b3a8-e9717b1c4e43.png) |\n| `burnt-neon` | ![image](https://user-images.githubusercontent.com/112064697/250343082-de641726-1200-4264-885a-154d539cfc3f.png) |\n| `humoris` | ![image](https://user-images.githubusercontent.com/20955511/263020536-793bedbd-cca6-47e5-92dc-c7b38ab05bce.png) |\n| `shadow-red` | ![image](https://user-images.githubusercontent.com/86386385/263407052-345edfdf-b6ee-4b53-a4c4-7dcb4948f6dc.png) |\n| `shadow-green` | ![image](https://user-images.githubusercontent.com/86386385/263407047-d769c2cf-e435-4d46-9a34-04c16f61d200.png) |\n| `shadow-blue` | ![image](https://user-images.githubusercontent.com/86386385/263407038-bdcd2ed9-4d2c-4a46-b8df-1b989ee517f5.png) |\n| `shadow-orange` | ![image](https://user-images.githubusercontent.com/86386385/263406777-07fd919b-7b4f-4fa9-ac47-3ebd0602a80b.png) |\n| `shadow-purple` | ![image](https://user-images.githubusercontent.com/86386385/263406551-46e14eac-fdbc-4b90-9df8-85c0bd1eeb41.png) |\n| `shadow-brown` | ![image](https://user-images.githubusercontent.com/86386385/263406156-5e17541d-4dcf-4315-b68d-d36c95d53767.png) |\n| `github-dark-dimmed` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/b29e3fe2-86ca-4bf5-81ce-9f6187b02c99) |\n| `blue-navy` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/29a78acd-56e8-465d-aff0-f984ecc14423) |\n| `calm-pink` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/7a789c2c-33d7-41a9-8a6e-034bbfe3e915) |\n| `whatsapp-light` | ![image](https://user-images.githubusercontent.com/86386385/266839259-1fe6a2b7-d2f2-46b0-b94d-397ff3f2a95a.png) |\n| `whatsapp-dark` | ![image](https://user-images.githubusercontent.com/86386385/266839261-d9a4a98c-ef9f-45ab-a3d6-1dca785225c3.png) |\n| `carbonfox` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/a26f8086-91de-49d7-83ca-8453cd031e72) |\n| `dawnfox` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/feff8dd8-d7c0-4d1d-9a84-129f1333a9e7) |\n| `dayfox` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/74111bcb-9825-4d26-a2c8-abec3618274f) |\n| `duskfox` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/8dfd700c-e391-4ba0-a434-db4d4455000d) |\n| `nightfox` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/00ab9a73-67d6-430f-8b22-da49a3e49091) |\n| `nordfox` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/6feef268-ed8f-4d60-bbd8-f7a0a7a58ce8) |\n| `terafox` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/ef943ced-365f-4ce5-965a-a9499ce1d8e1) |\n| `iceberg` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/912d8f6a-ba21-4668-9109-300c67a1f1c2) |\n| `whatsapp-light2` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/45d22825-e71b-42c7-aabf-14f50d47beef) |\n| `whatsapp-dark2` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/86386385/4b41e537-368f-4f67-a1e6-81ca757ce5f7) |\n| `travelers-theme` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/20955511/45b0bb8c-fb88-4f2e-ad97-665db6bce4a7) |\n| `youtube-dark` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/62086478/6f774511-2477-46d2-b7bd-de3a57a3ca78) |\n| `meta-light` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/105522342/c9429386-0b15-4efc-9bf0-c67f4aec05d4) |\n| `meta-dark` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/105522342/62119e5a-29fc-4285-ac5d-4125c49dff8c) |\n| `dark-minimalist` | ![image](https://github.com/DenverCoder1/github-readme-streak-stats/assets/77511070/11ba7899-1ad3-4c4b-880b-6f9e7c285f1b) |\n| `telegram` | ![image](https://github.com/user-attachments/assets/59a5d9d5-8a2a-4916-aa46-a0a49a6f0372) |\n| `taiga` | ![image](https://github.com/user-attachments/assets/be4e961d-a13e-401a-90f8-f2b062a8c0f9) |\n| `telegram-gradient` | ![image](https://github.com/user-attachments/assets/985c3e04-a5dd-4cba-a66e-d43ad9668af0) |\n| `microsoft` | ![image](https://github.com/user-attachments/assets/4c2cce9d-90b5-4e38-8422-656c5a78b4d9) |\n| `microsoft-dark` | ![image](https://github.com/user-attachments/assets/a5918d7d-f568-4012-b06f-d9cfacaece04) |\n| `hacker-inverted` | ![image](https://github.com/user-attachments/assets/b64c136a-827b-4177-98f9-28db59bba0ef) |\n| `rust-ferris-light` | ![image](https://github.com/user-attachments/assets/2e1d175f-c39d-4e56-be41-d9c277f1e83a) |\n| `rust-ferris-dark` | ![image](https://github.com/user-attachments/assets/05e3f9ac-708d-415d-990f-ede3d0a84bab) |\n| `cyber-streakglow` | ![image](https://github.com/user-attachments/assets/8c6108e1-f3a1-4653-9f68-08ed6dcfc498) |\n| `vitesse` | ![image](https://github.com/user-attachments/assets/baa2fa20-36ea-4158-befc-79c21f102f87) |\n| `nord-aurora` | ![image](https://github.com/user-attachments/assets/d61bf5c3-66f2-4c02-bd9d-30bf1be47c97) |\n| `dark-aura` | ![Image](https://github.com/user-attachments/assets/14889d0e-26db-4fa6-8026-6312c9b4636e) |\n| `everforest-dark` | ![image](https://github.com/user-attachments/assets/45a4e0a0-d330-4233-9d76-89003e59bb31) |\n| `everforest-light` | ![image](https://github.com/user-attachments/assets/592466c0-5a67-48cc-adf0-f8a21ca891b6) |\n| `oceanic-next` | ![image](https://github.com/user-attachments/assets/e0182770-a511-42b6-a40b-644317268a0f) |\n| `kanagawa-paper` | ![image](https://github.com/user-attachments/assets/541a521d-a6a8-4b55-ab79-7b1a9bdb092c) |\n| `sakura-x` | ![image](https://github.com/user-attachments/assets/65360cfa-9d5e-42f2-b3c9-cc2815623413) |\n\n### Can't find the theme you like?\n\nYou can now customize your stats card with the interactive [Demo Site](https://streak-stats.demolab.com/demo/) or by customizing the [url parameters](/README.md#-options).\n\nIf you would like to share your theme with others, feel free to open an issue/pull request!\n\nNote: When submitting a new theme, make sure the name is all lowercase. Hyphens are allowed between words, but there should be no underscores. On the demo site, you can export a list of colors from the advanced section by clicking \"Export to PHP\".\n" }, { "path": "package.json", "content": "{\n \"engines\": {\n \"node\": \"22.x\"\n },\n \"devDependencies\": {\n \"@prettier/plugin-php\": \"^0.24.0\",\n \"prettier\": \"^3.6.2\"\n }\n}\n" }, { "path": "scripts/translation-progress.php", "content": " $phrases) {\n // skip aliases\n if (is_string($phrases)) {\n continue;\n }\n $translated = 0;\n foreach ($phrases_to_translate as $phrase) {\n if (isset($phrases[$phrase])) {\n $translated++;\n }\n }\n $percentage = round(($translated / count($phrases_to_translate)) * 100);\n $locale_name = Locale::getDisplayName($locale, $locale);\n $line_number = getLineNumber($translations_file, $locale);\n $progress[$locale] = [\n \"locale\" => $locale,\n \"locale_name\" => $locale_name,\n \"percentage\" => $percentage,\n \"line_number\" => $line_number,\n ];\n }\n // sort by percentage\n uasort($progress, function ($a, $b) {\n return $b[\"percentage\"] <=> $a[\"percentage\"];\n });\n return $progress;\n}\n\n/**\n * Get the line number of the locale in the translations file\n *\n * @param array $translations_file The translations file\n * @param string $locale The locale\n * @return int The line number of the locale in the translations file\n */\nfunction getLineNumber(array $translations_file, string $locale): int\n{\n return key(preg_grep(\"/^\\\\s*\\\"$locale\\\"\\\\s*=>\\\\s*\\\\[/\", $translations_file)) + 1;\n}\n\n/**\n * Convert progress to labeled badges\n *\n * @param array $progress The progress array\n * @return string The markdown for the image badges\n */\nfunction progressToBadges(array $progress): string\n{\n $per_row = 5;\n $table = \"\";\n $i = 0;\n foreach (array_values($progress) as $data) {\n if ($i % $per_row === 0) {\n $table .= \"\";\n }\n $line_url = \"https://github.com/DenverCoder1/github-readme-streak-stats/blob/main/src/translations.php#L{$data[\"line_number\"]}\";\n $table .= \"\";\n $i++;\n if ($i % $per_row === 0) {\n $table .= \"\";\n }\n }\n if ($i % $per_row !== 0) {\n while ($i % $per_row !== 0) {\n $table .= \"\";\n $i++;\n }\n $table .= \"\";\n }\n $table .= \"
{$data[\"locale\"]} - {$data[\"locale_name\"]}
\\\"{$data[\"locale_name\"]}
\\n\";\n return $table;\n}\n\n/**\n * Update readme by replacing the content between the start and end markers\n *\n * @param string $path The path to the readme file\n * @param string $start The start marker\n * @param string $end The end marker\n * @param string $content The content to replace the content between the start and end markers\n * @return int|false The number of bytes that were written to the file, or false on failure\n */\nfunction updateReadme(string $path, string $start, string $end, string $content): int|false\n{\n $readme = file_get_contents($path);\n if (strpos($readme, $start) === false || strpos($readme, $end) === false) {\n throw new Exception(\"Start or end marker not found in readme\");\n }\n $start_pos = strpos($readme, $start) + strlen($start);\n $end_pos = strpos($readme, $end);\n $length = $end_pos - $start_pos;\n $readme = substr_replace($readme, $content, $start_pos, $length);\n return file_put_contents($path, $readme);\n}\n\n$progress = getProgress($GLOBALS[\"TRANSLATIONS\"]);\n$badges = \"\\n\" . progressToBadges($progress);\n$update = updateReadme(\n __DIR__ . \"/../README.md\",\n \"\",\n \"\",\n $badges,\n);\nexit($update === false ? 1 : 0);\n" }, { "path": "src/cache.php", "content": " $user, \"options\" => $options], JSON_THROW_ON_ERROR);\n } catch (JsonException $e) {\n // Fallback to simple concatenation if JSON encoding fails\n error_log(\"Cache key JSON encoding failed: \" . $e->getMessage());\n $keyData = $user . serialize($options);\n }\n return hash(\"sha256\", $keyData);\n}\n\n/**\n * Get the cache file path for a given key\n *\n * @param string $key Cache key\n * @return string Full path to cache file\n */\nfunction getCacheFilePath(string $key): string\n{\n return CACHE_DIR . \"/\" . $key . \".json\";\n}\n\n/**\n * Ensure the cache directory exists\n *\n * @return bool True if directory exists or was created\n */\nfunction ensureCacheDir(): bool\n{\n if (!is_dir(CACHE_DIR)) {\n return mkdir(CACHE_DIR, 0755, true);\n }\n return true;\n}\n\n/**\n * Get cached stats if available and not expired\n *\n * @param string $user GitHub username\n * @param array $options Additional options\n * @param int $maxAge Maximum age in seconds (default: 24 hours)\n * @return array|null Cached stats array or null if not cached/expired\n */\nfunction getCachedStats(string $user, array $options = [], int $maxAge = CACHE_DURATION): ?array\n{\n $key = getCacheKey($user, $options);\n $filePath = getCacheFilePath($key);\n\n if (!file_exists($filePath)) {\n return null;\n }\n\n $mtime = filemtime($filePath);\n if ($mtime === false) {\n return null;\n }\n\n $fileAge = time() - $mtime;\n if ($fileAge > $maxAge) {\n unlink($filePath);\n return null;\n }\n\n $handle = fopen($filePath, \"r\");\n if ($handle === false) {\n return null;\n }\n\n if (!flock($handle, LOCK_SH)) {\n fclose($handle);\n return null;\n }\n\n $contents = stream_get_contents($handle);\n flock($handle, LOCK_UN);\n fclose($handle);\n\n if ($contents === false || $contents === \"\") {\n return null;\n }\n\n $data = json_decode($contents, true);\n if (!is_array($data)) {\n return null;\n }\n\n return $data;\n}\n\n/**\n * Save stats to cache\n *\n * @param string $user GitHub username\n * @param array $options Additional options\n * @param array $stats Stats array to cache\n * @return bool True if successfully cached\n */\nfunction setCachedStats(string $user, array $options, array $stats): bool\n{\n if (!ensureCacheDir()) {\n error_log(\"Failed to create cache directory: \" . CACHE_DIR);\n return false;\n }\n\n $key = getCacheKey($user, $options);\n $filePath = getCacheFilePath($key);\n\n $data = json_encode($stats);\n if ($data === false) {\n error_log(\"Failed to encode stats to JSON for user: \" . $user);\n return false;\n }\n\n $result = file_put_contents($filePath, $data, LOCK_EX);\n if ($result === false) {\n error_log(\"Failed to write cache file: \" . $filePath);\n return false;\n }\n\n return true;\n}\n\n/**\n * Clear all expired cache files\n *\n * @param int $maxAge Maximum age in seconds\n * @return int Number of files deleted\n */\nfunction clearExpiredCache(int $maxAge = CACHE_DURATION): int\n{\n if (!is_dir(CACHE_DIR)) {\n return 0;\n }\n\n $deleted = 0;\n $files = glob(CACHE_DIR . \"/*.json\");\n\n if ($files === false) {\n return 0;\n }\n\n foreach ($files as $file) {\n $mtime = filemtime($file);\n if ($mtime === false) {\n continue;\n }\n $fileAge = time() - $mtime;\n if ($fileAge > $maxAge) {\n if (unlink($file)) {\n $deleted++;\n }\n }\n }\n\n return $deleted;\n}\n\n/**\n * Clear cache for a specific user\n *\n * Note: This function only clears the cache for the user with empty/default options.\n * Cache entries with non-empty options (starting_year, mode, exclude_days) will NOT\n * be cleared. This is a limitation of the hash-based cache key system - we cannot\n * enumerate all possible option combinations without storing additional metadata.\n *\n * @param string $user GitHub username\n * @return bool True if cache was cleared (or didn't exist)\n */\nfunction clearUserCache(string $user): bool\n{\n if (!is_dir(CACHE_DIR)) {\n return true;\n }\n\n $key = getCacheKey($user, []);\n $filePath = getCacheFilePath($key);\n\n if (file_exists($filePath)) {\n return unlink($filePath);\n }\n\n return true;\n}\n" }, { "path": "src/card.php", "content": "getBestPattern(\"MMM d\");\n $dateFormatter = new IntlDateFormatter(\n $locale,\n IntlDateFormatter::MEDIUM,\n IntlDateFormatter::NONE,\n pattern: $pattern,\n );\n $formatted = $dateFormatter->format($date);\n }\n }\n // otherwise, display month, day, and year\n else {\n if ($format) {\n // remove brackets, but leave text within them\n $formatted = date_format($date, str_replace([\"[\", \"]\"], \"\", $format));\n } else {\n // format with year using locale\n $pattern = $patternGenerator->getBestPattern(\"yyyy MMM d\");\n $dateFormatter = new IntlDateFormatter(\n $locale,\n IntlDateFormatter::MEDIUM,\n IntlDateFormatter::NONE,\n pattern: $pattern,\n );\n $formatted = $dateFormatter->format($date);\n }\n }\n // sanitize and return formatted date\n return htmlspecialchars($formatted);\n}\n\n/**\n * Translate days of the week\n *\n * Takes a list of days (eg. [\"Sun\", \"Mon\", \"Sat\"]) and returns the short abbreviation of the days of the week in another locale\n * e.g. [\"Sun\", \"Mon\", \"Sat\"] -> [\"dim\", \"lun\", \"sam\"]\n *\n * @param array $days List of days to translate\n * @param string $locale Locale code\n *\n * @return array Translated days\n */\nfunction translateDays(array $days, string $locale): array\n{\n if ($locale === \"en\") {\n return $days;\n }\n $patternGenerator = new IntlDatePatternGenerator($locale);\n $pattern = $patternGenerator->getBestPattern(\"EEE\");\n $dateFormatter = new IntlDateFormatter(\n $locale,\n IntlDateFormatter::NONE,\n IntlDateFormatter::NONE,\n pattern: $pattern,\n );\n $translatedDays = [];\n foreach ($days as $day) {\n $translatedDays[] = $dateFormatter->format(new DateTime($day));\n }\n return $translatedDays;\n}\n\n/**\n * Get the excluding days text\n *\n * @param array $excludedDays List of excluded days\n * @param array $localeTranslations Translations for the locale\n * @param string $localeCode Locale code\n * @return string Excluding days text\n */\nfunction getExcludingDaysText($excludedDays, $localeTranslations, $localeCode)\n{\n $separator = $localeTranslations[\"comma_separator\"] ?? \", \";\n $daysCommaSeparated = implode($separator, translateDays($excludedDays, $localeCode));\n return str_replace(\"{days}\", $daysCommaSeparated, $localeTranslations[\"Excluding {days}\"]);\n}\n\n/**\n * Normalize a theme name\n *\n * @param string $theme Theme name\n * @return string Normalized theme name\n */\nfunction normalizeThemeName(string $theme): string\n{\n return strtolower(str_replace(\"_\", \"-\", $theme));\n}\n\n/**\n * Check theme and color customization parameters to generate a theme mapping\n *\n * @param array $params Request parameters\n * @return array The chosen theme or default\n */\nfunction getRequestedTheme(array $params): array\n{\n /**\n * @var array> $THEMES\n * List of theme names mapped to labeled colors\n */\n $THEMES = include \"themes.php\";\n\n /**\n * @var array $CSS_COLORS\n * List of valid CSS colors\n */\n $CSS_COLORS = include \"colors.php\";\n\n // normalize theme name\n $selectedTheme = normalizeThemeName($params[\"theme\"] ?? \"default\");\n\n // get theme colors, or default colors if theme not found\n $theme = $THEMES[$selectedTheme] ?? $THEMES[\"default\"];\n\n // personal theme customizations\n $properties = array_keys($theme);\n foreach ($properties as $prop) {\n // check if each property was passed as a parameter\n if (isset($params[$prop])) {\n // ignore case\n $param = strtolower($params[$prop]);\n // check if color is valid hex color (3, 4, 6, or 8 hex digits)\n if (preg_match(\"/^([a-f0-9]{3}|[a-f0-9]{4}|[a-f0-9]{6}|[a-f0-9]{8})$/\", $param)) {\n // set property\n $theme[$prop] = \"#\" . $param;\n }\n // check if color is valid css color\n elseif (in_array($param, $CSS_COLORS)) {\n // set property\n $theme[$prop] = $param;\n }\n // if the property is background gradient is allowed (angle,start_color,...,end_color)\n elseif ($prop == \"background\" && preg_match(\"/^-?[0-9]+,[a-f0-9]{3,8}(,[a-f0-9]{3,8})+$/\", $param)) {\n // set property\n $theme[$prop] = $param;\n }\n }\n }\n\n // hide borders\n if (isset($params[\"hide_border\"]) && $params[\"hide_border\"] == \"true\") {\n $theme[\"border\"] = \"#0000\"; // transparent\n }\n\n // set background\n $gradient = \"\";\n $backgroundParts = explode(\",\", $theme[\"background\"] ?? \"\");\n if (count($backgroundParts) >= 3) {\n $theme[\"background\"] = \"url(#gradient)\";\n $gradient = \"\";\n $backgroundColors = array_slice($backgroundParts, 1);\n $colorCount = count($backgroundColors);\n for ($index = 0; $index < $colorCount; $index++) {\n $offset = ($index * 100) / ($colorCount - 1);\n $gradient .= \"\";\n }\n $gradient .= \"\";\n }\n $theme[\"backgroundGradient\"] = $gradient;\n\n return $theme;\n}\n\n/**\n * Wraps a string to a given number of characters\n *\n * Similar to `wordwrap()`, but uses regex and does not break with certain non-ascii characters\n *\n * @param string $string The input string\n * @param int $width The number of characters at which the string will be wrapped\n * @param string $break The line is broken using the optional `break` parameter\n * @param bool $cut_long_words If the `cut_long_words` parameter is set to true, the string is\n * the string is always wrapped at or before the specified width. So if you have\n * a word that is larger than the given width, it is broken apart.\n * When false the function does not split the word even if the width is smaller\n * than the word width.\n * @return string The given string wrapped at the specified length\n */\nfunction utf8WordWrap(string $string, int $width = 75, string $break = \"\\n\", bool $cut_long_words = false): string\n{\n // match anything 1 to $width chars long followed by whitespace or EOS\n $string = preg_replace(\"/(.{1,$width})(?:\\s|$)/uS\", \"$1$break\", $string);\n // split words that are too long after being broken up\n if ($cut_long_words) {\n $string = preg_replace(\"/(\\S{\" . $width . \"})(?=\\S)/u\", \"$1$break\", $string);\n }\n // trim any trailing line breaks\n return rtrim($string, $break);\n}\n\n/**\n * Get the length of a string with utf8 characters\n *\n * Similar to `strlen()`, but uses regex and does not break with certain non-ascii characters\n *\n * @param string $string The input string\n * @return int The length of the string\n */\nfunction utf8Strlen(string $string): int\n{\n return preg_match_all(\"/./us\", $string, $matches);\n}\n\n/**\n * Split lines of text using elements if it contains a newline or exceeds a maximum number of characters\n *\n * @param string $text Text to split\n * @param int $maxChars Maximum number of characters per line\n * @param int $line1Offset Offset for the first line\n * @return string Original text if one line, or split text with elements\n */\nfunction splitLines(string $text, int $maxChars, int $line1Offset): string\n{\n // if too many characters, insert \\n before a \" \" or \"-\" if possible\n if ($maxChars > 0 && utf8Strlen($text) > $maxChars && strpos($text, \"\\n\") === false) {\n // prefer splitting at \" - \" if possible\n if (strpos($text, \" - \") !== false) {\n $text = str_replace(\" - \", \"\\n- \", $text);\n }\n // otherwise, use word wrap to split at spaces\n else {\n $text = utf8WordWrap($text, $maxChars, \"\\n\", true);\n }\n }\n $text = htmlspecialchars($text);\n return preg_replace(\n \"/^(.*)\\n(.*)/\",\n \"$1$2\",\n $text,\n );\n}\n\n/**\n * Normalize a locale code\n *\n * @param string $localeCode Locale code\n * @return string Normalized locale code\n */\nfunction normalizeLocaleCode(string $localeCode): string\n{\n preg_match(\"/^([a-z]{2,3})(?:[_-]([a-z]{4}))?(?:[_-]([0-9]{3}|[a-z]{2}))?$/i\", $localeCode, $matches);\n if (empty($matches)) {\n return \"en\";\n }\n $language = $matches[1];\n $script = $matches[2] ?? \"\";\n $region = $matches[3] ?? \"\";\n // convert language to lowercase\n $language = strtolower($language);\n // convert script to title case\n $script = ucfirst(strtolower($script));\n // convert region to uppercase\n $region = strtoupper($region);\n // combine language, script, and region using underscores\n return implode(\"_\", array_filter([$language, $script, $region]));\n}\n\n/**\n * Get the translations for a locale code after normalizing it\n *\n * @param string $localeCode Locale code\n * @return array Translations for the locale code\n */\nfunction getTranslations(string $localeCode): array\n{\n // normalize locale code\n $localeCode = normalizeLocaleCode($localeCode);\n // get the labels from the translations file\n $translations = include \"translations.php\";\n // if the locale does not exist, try without the script and region\n if (!isset($translations[$localeCode])) {\n $localeCode = explode(\"_\", $localeCode)[0];\n }\n // get the translations for the locale or empty array if it does not exist\n $localeTranslations = $translations[$localeCode] ?? [];\n // if the locale returned is a string, it is an alias for another locale\n if (is_string($localeTranslations)) {\n // get the translations for the alias\n $localeTranslations = $translations[$localeTranslations];\n }\n // fill in missing translations with English\n $localeTranslations += $translations[\"en\"];\n // return the translations\n return $localeTranslations;\n}\n\n/**\n * Get the card width from params taking into account minimum and default values\n *\n * @param array $params Request parameters\n * @param int $numColumns Number of columns in the card\n * @return int Card width\n */\nfunction getCardWidth(array $params, int $numColumns = 3): int\n{\n $defaultWidth = 495;\n $minimumWidth = 100 * $numColumns;\n return max($minimumWidth, intval($params[\"card_width\"] ?? $defaultWidth));\n}\n\n/**\n * Get the card height from params taking into account minimum and default values\n *\n * @param array $params Request parameters\n * @return int Card width\n */\nfunction getCardHeight(array $params): int\n{\n $defaultHeight = 195;\n $minimumHeight = 170;\n return max($minimumHeight, intval($params[\"card_height\"] ?? $defaultHeight));\n}\n\n/**\n * Format number using locale and short number if requested\n *\n * @param float $num The number to format\n * @param string $localeCode Locale code\n * @param bool $useShortNumbers Whether to use short numbers\n * @return string The formatted number\n */\nfunction formatNumber(float $num, string $localeCode, bool $useShortNumbers): string\n{\n $numFormatter = new NumberFormatter($localeCode, NumberFormatter::DECIMAL);\n $suffix = \"\";\n if ($useShortNumbers) {\n $units = [\"\", \"K\", \"M\", \"B\", \"T\"];\n for ($i = 0; $num >= 1000; $i++) {\n $num /= 1000;\n }\n $suffix = $units[$i];\n $num = round($num, 1);\n }\n return $numFormatter->format($num) . $suffix;\n}\n\n/**\n * Generate SVG output for a stats array\n *\n * @param array $stats Streak stats\n * @param array|NULL $params Request parameters\n * @return string The generated SVG Streak Stats card\n *\n * @throws InvalidArgumentException If a locale does not exist\n */\nfunction generateCard(array $stats, array $params = null): string\n{\n $params = $params ?? $_REQUEST;\n\n // get requested theme\n $theme = getRequestedTheme($params);\n\n // get requested locale, default to English\n $localeCode = $params[\"locale\"] ?? \"en\";\n $localeTranslations = getTranslations($localeCode);\n\n // whether the locale is right-to-left\n $direction = $localeTranslations[\"rtl\"] ?? false ? \"rtl\" : \"ltr\";\n\n // get date format\n // locale date formatter (used only if date_format is not specified)\n $dateFormat = $params[\"date_format\"] ?? ($localeTranslations[\"date_format\"] ?? null);\n\n // read border_radius parameter, default to 4.5 if not set\n $borderRadius = $params[\"border_radius\"] ?? 4.5;\n\n $showTotalContributions = ($params[\"hide_total_contributions\"] ?? \"\") !== \"true\";\n $showCurrentStreak = ($params[\"hide_current_streak\"] ?? \"\") !== \"true\";\n $showLongestStreak = ($params[\"hide_longest_streak\"] ?? \"\") !== \"true\";\n $numColumns = intval($showTotalContributions) + intval($showCurrentStreak) + intval($showLongestStreak);\n\n $cardWidth = getCardWidth($params, $numColumns);\n $rectWidth = $cardWidth - 1;\n $columnWidth = $numColumns > 0 ? $cardWidth / $numColumns : 0;\n\n $cardHeight = getCardHeight($params);\n $rectHeight = $cardHeight - 1;\n $heightOffset = ($cardHeight - 195) / 2;\n\n // X offsets for the bars between columns\n $barOffsets = [-999, -999];\n for ($i = 0; $i < $numColumns - 1; $i++) {\n $barOffsets[$i] = $columnWidth * ($i + 1);\n }\n // offsets for the text in each column\n $columnOffsets = [];\n for ($i = 0; $i < $numColumns; $i++) {\n $columnOffsets[] = $columnWidth / 2 + $columnWidth * $i;\n }\n // reverse the column offsets if the locale is right-to-left\n if ($direction === \"rtl\") {\n $columnOffsets = array_reverse($columnOffsets);\n }\n\n $nextColumnIndex = 0;\n $totalContributionsOffset = $showTotalContributions ? $columnOffsets[$nextColumnIndex++] : -999;\n $currentStreakOffset = $showCurrentStreak ? $columnOffsets[$nextColumnIndex++] : -999;\n $longestStreakOffset = $showLongestStreak ? $columnOffsets[$nextColumnIndex++] : -999;\n\n // Y offsets for the bars\n $barHeightOffsets = [28 + $heightOffset / 2, 170 + $heightOffset];\n // Y offsets for the numbers and dates\n $longestStreakHeightOffset = $totalContributionsHeightOffset = [\n 48 + $heightOffset,\n 84 + $heightOffset,\n 114 + $heightOffset,\n ];\n $currentStreakHeightOffset = [\n 48 + $heightOffset,\n 108 + $heightOffset,\n 145 + $heightOffset,\n 71 + $heightOffset,\n 19.5 + $heightOffset,\n ];\n\n $useShortNumbers = ($params[\"short_numbers\"] ?? \"\") === \"true\";\n\n // total contributions\n $totalContributions = formatNumber($stats[\"totalContributions\"], $localeCode, $useShortNumbers);\n $firstContribution = formatDate($stats[\"firstContribution\"], $dateFormat, $localeCode);\n $totalContributionsRange = $firstContribution . \" - \" . $localeTranslations[\"Present\"];\n\n // current streak\n $currentStreak = formatNumber($stats[\"currentStreak\"][\"length\"], $localeCode, $useShortNumbers);\n $currentStreakStart = formatDate($stats[\"currentStreak\"][\"start\"], $dateFormat, $localeCode);\n $currentStreakEnd = formatDate($stats[\"currentStreak\"][\"end\"], $dateFormat, $localeCode);\n $currentStreakRange = $currentStreakStart;\n if ($currentStreakStart != $currentStreakEnd) {\n $currentStreakRange .= \" - \" . $currentStreakEnd;\n }\n\n // longest streak\n $longestStreak = formatNumber($stats[\"longestStreak\"][\"length\"], $localeCode, $useShortNumbers);\n $longestStreakStart = formatDate($stats[\"longestStreak\"][\"start\"], $dateFormat, $localeCode);\n $longestStreakEnd = formatDate($stats[\"longestStreak\"][\"end\"], $dateFormat, $localeCode);\n $longestStreakRange = $longestStreakStart;\n if ($longestStreakStart != $longestStreakEnd) {\n $longestStreakRange .= \" - \" . $longestStreakEnd;\n }\n\n // if the translations contain over max characters or a newline, split the text into two tspan elements\n $maxCharsPerLineLabels = $numColumns > 0 ? intval(floor($cardWidth / $numColumns / 7.5)) : 0;\n $totalContributionsText = splitLines($localeTranslations[\"Total Contributions\"], $maxCharsPerLineLabels, -9);\n if ($stats[\"mode\"] === \"weekly\") {\n $currentStreakText = splitLines($localeTranslations[\"Week Streak\"], $maxCharsPerLineLabels, -9);\n $longestStreakText = splitLines($localeTranslations[\"Longest Week Streak\"], $maxCharsPerLineLabels, -9);\n } else {\n $currentStreakText = splitLines($localeTranslations[\"Current Streak\"], $maxCharsPerLineLabels, -9);\n $longestStreakText = splitLines($localeTranslations[\"Longest Streak\"], $maxCharsPerLineLabels, -9);\n }\n\n // if the ranges contain over max characters, split the text into two tspan elements\n $maxCharsPerLineDates = $numColumns > 0 ? intval(floor($cardWidth / $numColumns / 6)) : 0;\n $totalContributionsRange = splitLines($totalContributionsRange, $maxCharsPerLineDates, 0);\n $currentStreakRange = splitLines($currentStreakRange, $maxCharsPerLineDates, 0);\n $longestStreakRange = splitLines($longestStreakRange, $maxCharsPerLineDates, 0);\n\n // if days are excluded, add a note to the corner\n $excludedDays = \"\";\n if (!empty($stats[\"excludedDays\"])) {\n $offset = $direction === \"rtl\" ? $cardWidth - 5 : 5;\n $excludingDaysText = getExcludingDaysText($stats[\"excludedDays\"], $localeTranslations, $localeCode);\n $excludedDays = \"\n \n \n \n * {$excludingDaysText}\n \n \n \";\n }\n\n return \"\n \n \n \n \n \n \n \n \n \n {$theme[\"backgroundGradient\"]}\n \n \n \n \n \n \n \n \n \n \n \n \n \n {$totalContributions}\n \n \n\n \n \n \n {$totalContributionsText}\n \n \n\n \n \n \n {$totalContributionsRange}\n \n \n \n \n \n \n \n {$currentStreakText}\n \n \n\n \n \n \n {$currentStreakRange}\n \n \n\n \n \n \n \n \n \n \n \n \n\n \n \n \n {$currentStreak}\n \n \n\n \n \n \n \n \n {$longestStreak}\n \n \n\n \n \n \n {$longestStreakText}\n \n \n\n \n \n \n {$longestStreakRange}\n \n \n \n {$excludedDays}\n \n \n\";\n}\n\n/**\n * Generate SVG displaying an error message\n *\n * @param string $message The error message to display\n * @param array|NULL $params Request parameters\n * @return string The generated SVG error card\n */\nfunction generateErrorCard(string $message, array $params = null): string\n{\n $params = $params ?? $_REQUEST;\n\n // get requested theme, use $_REQUEST if no params array specified\n $theme = getRequestedTheme($params);\n\n // read border_radius parameter, default to 4.5 if not set\n $borderRadius = $params[\"border_radius\"] ?? 4.5;\n\n // read card_width parameter\n $cardWidth = getCardWidth($params);\n $rectWidth = $cardWidth - 1;\n $centerOffset = $cardWidth / 2;\n\n // read card_height parameter\n $cardHeight = getCardHeight($params);\n $rectHeight = $cardHeight - 1;\n $heightOffset = ($cardHeight - 195) / 2;\n $errorLabelOffset = $cardHeight / 2 + 10.5;\n\n return \"\n \n \n \n \n \n {$theme[\"backgroundGradient\"]}\n \n \n \n \n \n \n \n \n \n {$message}\n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\";\n}\n\n/**\n * Remove animations from SVG\n *\n * @param string $svg The SVG for the card as a string\n * @return string The SVG without animations\n */\nfunction removeAnimations(string $svg): string\n{\n $svg = preg_replace(\"/(