{"id":23053175,"url":"https://github.com/fairdataihub/analytics","last_synced_at":"2025-08-24T04:10:46.877Z","repository":{"id":150887201,"uuid":"623628538","full_name":"fairdataihub/analytics","owner":"fairdataihub","description":"🍄🚜🛖","archived":false,"fork":false,"pushed_at":"2024-02-06T00:49:43.000Z","size":836,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-01T18:25:08.278Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://analytics-nine-ashen.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fairdataihub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null}},"created_at":"2023-04-04T18:53:29.000Z","updated_at":"2023-06-21T17:52:47.000Z","dependencies_parsed_at":"2023-09-25T06:19:18.591Z","dependency_job_id":"28202ca8-d746-415b-a522-6017e1100e18","html_url":"https://github.com/fairdataihub/analytics","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fairdataihub%2Fanalytics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fairdataihub%2Fanalytics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fairdataihub%2Fanalytics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fairdataihub%2Fanalytics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fairdataihub","download_url":"https://codeload.github.com/fairdataihub/analytics/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229890102,"owners_count":18140043,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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-16T00:16:46.990Z","updated_at":"2024-12-16T00:16:47.480Z","avatar_url":"https://github.com/fairdataihub.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://freesvg.org/img/1653682897science-svgrepo-com.png\" alt=\"logo\" width=\"200\" height=\"auto\" /\u003e\n\n\u003cbr /\u003e\n\n\u003ch1\u003eKombucha\u003c/h1\u003e\n\n\u003cp\u003e\nA lightweight, open-source, and privacy-friendly app-usage tracking platform that supports logging both logs and events\n\u003c/p\u003e\n\n\u003cbr /\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/fairdataihub/analytic/graphs/contributors\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/contributors/fairdataihub/analytics.svg?style=flat-square\" alt=\"contributors\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/fairdataihub/analytics/stargazers\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/fairdataihub/analytics.svg?style=flat-square\" alt=\"stars\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/fairdataihub/analytics/issues/\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/fairdataihub/analytics.svg?style=flat-square\" alt=\"open issues\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/fairdataihub/analytics/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/fairdataihub/analytics.svg?style=flat-square\" alt=\"license\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003ch4\u003e\n    \u003ca href=\"#\"\u003eDocumentation\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"#\"\u003eChangelog\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"https://github.com/fairdataihub/analytics/issues/\"\u003eReport Bug\u003c/a\u003e\n  \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"#\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/h4\u003e\n\u003c/div\u003e\n\n\u003cbr /\u003e\n\n---\n\n## Description\n\nKombucha Analytics is a lightweight, open-source, and privacy-friendly app-usage tracking platform that supports logging both logs and events, providing a comprehensive solution for all your usage tracking needs. With Kombucha Analytics, the only requirement is a MongoDB database, making it easy to integrate into your existing infrastructure.\n\nThe platform can be easily deployed on platforms like Vercel and Netlify, leveraging serverless functions for efficient operation. This flexibility allows you to seamlessly incorporate Kombucha Analytics into your preferred hosting environment.\n\nVisualize your tracked data with the built-in frontend, which can be customized to suit your specific preferences. Gain valuable insights into user behavior and app performance without compromising on privacy.\nKombucha Analytics also offers advanced alert monitoring capabilities, ensuring proactive issue resolution based on tracked events. By promptly addressing any concerns in your app, you can deliver an exceptional user experience.\n\nIt is important to note that Kombucha is not intended for user or web tracking purposes. Rather, it operates as a REST web endpoint, allowing developers to intentionally store data from any source that accesses the internet. By default, Kombucha does not automatically track click events, page navigation, or similar user interactions. Developers must intentionally send this information if they wish to store it on the platform.\nChoose Kombucha Analytics as your go-to solution for powerful, privacy-conscious, and user-friendly app usage tracking.\n\n## Getting Started\n\n### Prerequisites/Dependencies\n\n[Node.js](https://nodejs.org/en/) (v18 or higher)\n\n[Yarn package manager](https://yarnpkg.com/getting-started/install) (v1.22 or higher)\n\n**Front-end Framework:** The front-end of the application is built with TypeScript and Next.js, which provides a fast and efficient way to develop modern web applications.\n\n**Styling:** The app's UI is styled using Tailwind.css, a highly customizable CSS framework that enables rapid development and consistent design.\n\n**Database:** MongoDB is used as the database for this project, providing a flexible and scalable solution for data storage.\n\n**User Authentication:** The app authenticates users using OAuth2 and integrates with the GitHub API. This allows users to securely log in to the application using their GitHub credentials.\n\n### Installing\n\nTo set up the project locally, follow these steps:\n\nClone the repository:\n\n```bash\ngit clone https://github.com/fairdataihub/analytics.git\n```\n\nInstall the required dependencies:\n\n```bash\nyarn install\n```\n\nConfigure the OAuth2 authentication with the FairdataiHub organization's credentials (or your own Oauth2 credentials), and obtain the client ID and client secret.\nCreate a `.env.local` file in the root directory of the project and add the following environment variables:\n\n```bash\nMONGODB_URI=\nMONGODB_DBNAME=\nGITHUB_ID=\nGITHUB_SECRET=\nGITHUB_ORG=\nNEXTAUTH_SECRET=\n```\n\nStart the application:\n\n```bash\nyarn dev\n```\n\nAccess the application in your browser at \u003chttp://localhost:3000\u003e\n\n\u003e**Note**:\n\u003eSigning in to the application requires a GitHub account that is a member of the FairdataiHub organization. To change to a different organization, update the `GITHUB_ORG` environment variable in the `.env.local` file.\n\n### Contributing\n\n\u003ca href=\"https://github.com/fairdataihub/analytics/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=fairdataihub/analytics\" /\u003e\n\u003c/a\u003e\n\nIf you are interested in reporting/fixing issues and contributing directly to the code base, please see [CONTRIBUTING.md](CONTRIBUTING.md) for more information on what we're looking for and how to get started.\n\nFor any developmental standards to follow, add them directly to the [CONTRIBUTING.md](CONTRIBUTING.md) file.\n\n## Issues and Feedback\n\nTo report any issues with the web application, suggest improvements, or request a new feature, please open a new issue via the [Issues](https://github.com/fairdataihub/analytics/issues) tab. Provide adequate information (browser, steps leading to error, screenshots) so we can help you efficiently.\n\n## License\n\nThis work is licensed under\n[MIT](https://opensource.org/licenses/mit). See [LICENSE](https://github.com/fairdataihub/analytics/blob/main/LICENSE) for more information.\n\n\u003ca href=\"https://fairdataihub.org/\" \u003e\n  \u003cimg src=\"https://www.channelfutures.com/files/2017/04/3_0.png\" height=\"30\" /\u003e\n\u003c/a\u003e\n\n## How to cite\n\nIf you are using this software or reusing the source code from this repository for any purpose, please cite:\n\n```bash\n    Coming soon\n```\n\n## Acknowledgements\n\nThis project is funded by the NIH under award number 1OT2OD030213-01 . The content is solely the responsibility of the authors and does not necessarily represent the official views of the NIH.\n\n\u003cbr /\u003e\n\n---\n\n\u003cbr /\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://fairdataihub.org/\"\u003e\n  \u003cimg src=\"https://fairdataihub.org/logo.svg\" alt=\"logo\" width=\"600\" height=\"auto\" /\u003e\n\u003c/a\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffairdataihub%2Fanalytics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffairdataihub%2Fanalytics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffairdataihub%2Fanalytics/lists"}