{"id":22631665,"url":"https://github.com/getpinga/tide","last_synced_at":"2026-03-01T18:07:06.403Z","repository":{"id":176710256,"uuid":"659453976","full_name":"getpinga/tide","owner":"getpinga","description":"Tide client area theme for FOSSBilling","archived":false,"fork":false,"pushed_at":"2026-02-23T10:24:11.000Z","size":17498,"stargazers_count":32,"open_issues_count":2,"forks_count":15,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-02-23T19:04:51.682Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getpinga.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://donate.stripe.com/7sI2aI4jV3Offn28ww","https://www.blockchain.com/btc/address/bc1q9jhxjlnzv0x4wzxfp8xzc6w289ewggtds54uqa","https://etherscan.io/address/0x330c1b148368EE4B8756B176f1766d52132f0Ea8"]}},"created_at":"2023-06-27T21:50:07.000Z","updated_at":"2026-02-23T10:24:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"79cfe67b-5663-4e67-ab40-ea8ab7d1ab6e","html_url":"https://github.com/getpinga/tide","commit_stats":null,"previous_names":["getpinga/tide"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/getpinga/tide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getpinga%2Ftide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getpinga%2Ftide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getpinga%2Ftide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getpinga%2Ftide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getpinga","download_url":"https://codeload.github.com/getpinga/tide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getpinga%2Ftide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29977972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T16:35:47.903Z","status":"ssl_error","status_checked_at":"2026-03-01T16:35:44.899Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-09T02:10:37.272Z","updated_at":"2026-03-01T18:07:06.397Z","avatar_url":"https://github.com/getpinga.png","language":"JavaScript","funding_links":["https://donate.stripe.com/7sI2aI4jV3Offn28ww","https://www.blockchain.com/btc/address/bc1q9jhxjlnzv0x4wzxfp8xzc6w289ewggtds54uqa","https://etherscan.io/address/0x330c1b148368EE4B8756B176f1766d52132f0Ea8"],"categories":[],"sub_categories":[],"readme":"# Tide Theme for FOSSBilling\n\n[![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)\n\n[![SWUbanner](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)\n\n## Overview\n\nTide is a client area theme for FOSSBilling. It's designed to enhance your user interface with a clean, modern aesthetic. This guide provides steps on how to install, upgrade, secure, and customize the Tide theme.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"screen1.jpeg\" width=\"48%\" /\u003e\n  \u003cimg src=\"screen2.png\" width=\"48%\" /\u003e\n\u003c/p\u003e\n\n## Compatibility\n\n- 1.1.x → FOSSBilling 0.7.2  \n- 1.2.x → FOSSBilling 0.8.x  \n\nInstall the Tide release that matches your FOSSBilling version.\n\n## Installation\n\nFollow these steps to install the Tide theme:\n\n1. Download or clone this repository.\n\n   - If you downloaded a ZIP file, extract it first.\n   - If you cloned the repository, locate the main project folder.\n  \n2. Inside the downloaded/cloned files, you will find a directory containing the theme files\n   (for example: `tide-main`, `tide-v1.1.0`, or similar).\n\n3. Rename this directory to `tide`.\n\n4. Move the renamed `tide` directory into your FOSSBilling themes folder: `FOSSBilling directory/themes`.\n\n5. Change the directory owner to the user your web server runs under. For example: `chown -Rf www-data:www-data tide/`.\n\n6. Set permissions to `750` using chmod: `chmod -Rf 750 tide/`.\n\n7. Navigate to `Settings -\u003e Themes` in the FOSSBilling admin panel and select `tide` as the default theme.\n\n## Upgrade\n\nTo upgrade to a newer version of the Tide theme, perform the following:\n\n1. Download or clone this repository.\n\n   - If you downloaded a ZIP file, extract it first.\n   - If you cloned the repository, locate the main project folder.\n  \n2. Inside the downloaded/cloned files, you will find a directory containing the theme files\n   (for example: `tide-main`, `tide-v1.1.0`, or similar).\n\n3. Rename this directory to `tide`.\n\n4. Backup your `FOSSBilling directory/themes/tide/config/settings_data.json` and any custom assets located at `FOSSBilling directory/themes/tide/assets/custom` and `FOSSBilling directory/themes/tide/html/custom`.\n\n5. Move the renamed `tide` directory into your FOSSBilling themes folder: `FOSSBilling directory/themes`, overwriting all files.\n\n6. Restore your `settings_data.json` and any custom assets from the backup.\n\n7. Change the directory owner to the web server user. For example: `chown -Rf www-data:www-data tide/`. Set permissions to `750` using chmod: `chmod -Rf 750 tide/`.\n\n### Upgrade from v1.1.3\n\nIf you customized your CSS in v1.1.3 or earlier, move `FOSSBilling directory/themes/tide/assets/css/extra.css` to `FOSSBilling directory/themes/tide/assets/custom/extra.css` before upgrading and follow Section 2 of the Theme Customization section below.\n\n### Security Measures for Prior Installations (Before 0.9.5)\n\nFor versions of Tide installed prior to 0.9.5, implement these security measures:\n\n1. Change the directory owner to the web server user. For example: `chown -Rf www-data:www-data tide/`.\n2. Set permissions to `750` using chmod: `chmod -Rf 750 tide/`.\n\n## Theme Customization\n\nTide is designed to be safely customizable without modifying core template files.  \nTo prevent your changes from being overwritten during updates, use the supported customization methods below.\n\n### 1. Dashboard Layout\n\nTide provides optional hook points that allow you to extend specific dashboard areas without editing core files.\n\nTo use them, create the following files inside `FOSSBilling directory/themes/tide/html/custom/`:\n\n`dashboard.top.twig` – customizes the top area of the dashboard  \n`dashboard.widgets.twig` – customizes the widgets section  \n`dashboard.bottom.twig` – customizes the bottom area of the dashboard  \n\nEach file corresponds to its respective dashboard area.  \nIt is safe if one or more of these files are missing — Tide will continue to function normally.\n\nFor consistent layout and spacing, follow the default Tide dashboard structure:\n\n- For `dashboard.top.twig` and `dashboard.bottom.twig`, wrap your content inside a Bootstrap `row row-cards` container and place elements inside `card` components.\n- For `dashboard.widgets.twig`, use a standard `row`, as it is already rendered within the dashboard widgets grid context.\n\nThis ensures visual consistency with the default Tide dashboard styling.\n\n### 2. Theme Colours\n\nTide allows you to replace the default colours with custom ones, so you can align the theme with your branding.\n\n1. Create the following file to load your custom CSS automatically:\n\n`FOSSBilling directory/themes/tide/html/custom/head.extra.twig`\n\nPaste this content inside:\n\n```twig\n\u003clink href=\"{{ 'custom/extra.css' | asset_url }}\" rel=\"stylesheet\"/\u003e\n```\n\n2. Create `FOSSBilling directory/themes/tide/assets/custom/extra.css` and place your custom CSS overrides inside it, following the example below.\n\n```css\n.bg-primary {\n     background-color: #your-color !important;\n}\n.text-primary {\n     color: #your-color !important;\n}\n.btn-primary {\n     background-color: #your-color !important;\n     border-color: #your-color !important;\n}\n.btn-primary:hover {\n     background-color: #your-hover-color !important;\n     border-color: #your-hover-color !important;\n}\n.btn-primary:focus {\n     background-color: #your-focus-color !important;\n     border-color: #your-focus-color !important;\n     box-shadow: 0 0 0 0.2rem rgba(#your-color, 0.5) !important;\n}\n.btn-primary:active {\n     background-color: #your-active-color !important;\n     border-color: #your-active-color !important;\n}\n.btn-primary:disabled {\n     background-color: #your-disabled-color !important;\n     border-color: #your-disabled-color !important;\n}\n```\n\nBecause this file is placed under `assets/custom/`, it is not part of the standard Tide files and will not be rewritten during a normal update.\n\nBackups are still encouraged as a best practice. However, you should not need to restore this file after upgrading unless your update process deletes the entire theme folder.\n\n## Support\n\nYour feedback and inquiries are invaluable to Namingo's evolutionary journey. If you need support, have questions, or want to contribute your thoughts:\n\n- **Email**: Feel free to reach out directly at [help@namingo.org](mailto:help@namingo.org).\n\n- **Discord**: Or chat with us on our [Discord](https://discord.gg/97R9VCrWgc) channel.\n  \n- **GitHub Issues**: For bug reports or feature requests, please use the [Issues](https://github.com/getpinga/tide/issues) section of our GitHub repository.\n\nWe appreciate your involvement and patience as Namingo continues to grow and adapt.\n\n## Support This Project\n\nIf you find Tide useful, consider donating:\n\n- [Donate via Stripe](https://donate.stripe.com/7sI2aI4jV3Offn28ww)\n- BTC: `bc1q9jhxjlnzv0x4wzxfp8xzc6w289ewggtds54uqa`\n- ETH: `0x330c1b148368EE4B8756B176f1766d52132f0Ea8`\n\n## Licensing\n\nTide is licensed under the Apache License, Version 2.0 starting from version 1.1.\n\nVersions 1.0 and earlier are licensed under the MIT License.\n\nThis project includes and builds upon code from Huraga, the default template of the FOSSBilling platform.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetpinga%2Ftide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetpinga%2Ftide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetpinga%2Ftide/lists"}