{"id":30016408,"url":"https://github.com/databuddy-analytics/Databuddy","last_synced_at":"2025-08-05T21:04:07.834Z","repository":{"id":305862759,"uuid":"946945328","full_name":"databuddy-analytics/Databuddy","owner":"databuddy-analytics","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-29T17:58:36.000Z","size":118959,"stargazers_count":220,"open_issues_count":11,"forks_count":25,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-29T18:21:02.848Z","etag":null,"topics":["alternative","analytics","europe","gdpr","gdpr-compliant","google-analytics","privacy","web-analytics"],"latest_commit_sha":null,"homepage":"https://www.databuddy.cc","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/databuddy-analytics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-11T23:23:43.000Z","updated_at":"2025-07-29T17:58:33.000Z","dependencies_parsed_at":"2025-07-22T12:29:14.969Z","dependency_job_id":null,"html_url":"https://github.com/databuddy-analytics/Databuddy","commit_stats":null,"previous_names":["databuddy-analytics/databuddy"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/databuddy-analytics/Databuddy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databuddy-analytics%2FDatabuddy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databuddy-analytics%2FDatabuddy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databuddy-analytics%2FDatabuddy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databuddy-analytics%2FDatabuddy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/databuddy-analytics","download_url":"https://codeload.github.com/databuddy-analytics/Databuddy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databuddy-analytics%2FDatabuddy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268972522,"owners_count":24338077,"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","status":"online","status_checked_at":"2025-08-05T02:00:12.334Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["alternative","analytics","europe","gdpr","gdpr-compliant","google-analytics","privacy","web-analytics"],"created_at":"2025-08-05T21:02:34.992Z","updated_at":"2025-08-05T21:04:07.802Z","avatar_url":"https://github.com/databuddy-analytics.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Databuddy\n\n\u003cdiv align=\"center\"\u003e\n\n[![License: AGPL](https://img.shields.io/badge/License-AGPL-red.svg)](LICENSE)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-blue.svg)](https://www.typescriptlang.org/)\n[![Next.js](https://img.shields.io/badge/Next.js-15.3-black.svg)](https://nextjs.org/)\n[![React](https://img.shields.io/badge/React-19.0-blue.svg)](https://reactjs.org/)\n[![Turborepo](https://img.shields.io/badge/Turborepo-1.12-blue.svg)](https://turbo.build/repo)\n[![Bun](https://img.shields.io/badge/Bun-1.2-blue.svg)](https://bun.sh/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind-3.4-blue.svg)](https://tailwindcss.com/)\n\n[![CodeRabbit Pull Request Reviews](https://img.shields.io/coderabbit/prs/github/databuddy-analytics/Databuddy?utm_source=oss\u0026utm_medium=github\u0026utm_campaign=databuddy-analytics%2FDatabuddy\u0026labelColor=171717\u0026color=FF570A\u0026link=https%3A%2F%2Fcoderabbit.ai\u0026label=CodeRabbit+Reviews)](https://coderabbit.ai)\n[![CI/CD](https://github.com/databuddy/databuddy/actions/workflows/ci.yml/badge.svg)](https://github.com/databuddy/databuddy/actions/workflows/ci.yml)\n[![Code Coverage](https://img.shields.io/badge/coverage-85%25-green.svg)](https://github.com/databuddy/databuddy/actions/workflows/coverage.yml)\n[![Security Scan](https://img.shields.io/badge/security-A%2B-green.svg)](https://github.com/databuddy/databuddy/actions/workflows/security.yml)\n[![Dependency Status](https://img.shields.io/badge/dependencies-up%20to%20date-green.svg)](https://github.com/databuddy/databuddy/actions/workflows/dependencies.yml)\n\n[![Discord](https://img.shields.io/discord/123456789?label=Discord\u0026logo=discord)](https://discord.gg/JTk7a38tCZ)\n[![GitHub Stars](https://img.shields.io/github/stars/databuddy-analytics/Databuddy?style=social)](https://github.com/databuddy-analytics/Databuddy/stargazers)\n[![Twitter](https://img.shields.io/twitter/follow/trydatabuddy?style=social)](https://twitter.com/trydatabuddy)\n\n\u003c/div\u003e\n\nA comprehensive analytics and data management platform built with Next.js, TypeScript, and modern web technologies. Databuddy provides real-time analytics, user tracking, and data visualization capabilities for web applications.\n\n## 🌟 Features\n\n- 📊 Real-time analytics dashboard\n- 👥 User behavior tracking\n- 📈 Advanced data visualization // Soon\n- 🔒 Secure authentication\n- 📱 Responsive design\n- 🌐 Multi-tenant support\n- 🔄 Real-time updates // Soon\n- 📊 Custom metrics // Soon\n- 🎯 Goal tracking\n- 📈 Conversion analytics\n- 🔍 Custom event tracking\n- 📊 Funnel analysis\n- 📈 Cohort analysis // Soon\n- 🔄 A/B testing // Soon\n- 📈 Export capabilities // Soon\n- 🔒 GDPR compliance\n- 🔐 Data encryption\n- 📊 API access\n\n## 📚 Table of Contents\n\n- [Getting Started](#-getting-started)\n- [Development](#-development)\n- [Contributing](#-contributing)\n- [Security](#-security)\n- [FAQ](#-faq)\n- [Support](#-support)\n- [License](#-license)\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Bun\n- PostgreSQL\n- Redis\n- Cloudflare account\n- Vercel account\n\n### Installation\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/databuddy/databuddy.git\ncd databuddy\n```\n\n2. Install dependencies:\n\n```bash\nbun install\n```\n\n3. Set up environment variables:\n\n```bash\ncp .env.example .env\n```\n\n4. Start Docker services (PostgreSQL, Redis, ClickHouse):\n\n```bash\ndocker-compose up -d\n```\n\n5. Set up the database:\n\n```bash\nbun db:push\n```\n\n6. Build the SDK:\n\n```bash\nbun sdk:build\n```\n\n7. Start development servers:\n\n```bash\nbun run dev\n```\n\n## 💻 Development\n\n### Available Scripts\n\nCheck the root `package.json` for available scripts. Here are some common ones:\n\n- `bun run dev` - Start all applications in development mode\n- `bun run build` - Build all applications\n- `bun run start` - Start all applications in production mode\n- `bun run lint` - Lint all code with Ultracite\n- `bun run format` - Format all code with Prettier\n- `bun run check-types` - Type check all TypeScript code\n- `bun run db:studio` - Open Drizzle Studio for database management\n- `bun run db:generate` - Generate Drizzle ORM types\n- `bun run db:push` - Apply database schema changes\n- `bun run db:migrate` - Run database migrations\n- `bun run db:deploy` - Deploy database migrations\n- `bun run sdk:build` - Build the SDK package\n- `bun run email:dev` - Start the email development server\n\nYou can also `cd` into any package and run its scripts directly.\n\n### Development Workflow\n\n1. Create a new branch:\n\n```bash\ngit checkout -b feature/your-feature\n```\n\n2. Make your changes\n\n3. Run tests:\n\n```bash\nbun run test\n```\n\n4. Create a changeset:\n\n```bash\nbun run changeset\n```\n\n5. Commit your changes:\n\n```bash\ngit add .\ngit commit -m \"feat: your feature\"\n```\n\n6. Push your changes:\n\n```bash\ngit push origin feature/your-feature\n```\n\n7. Create a Pull Request\n\n## 🤝 Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## 🔒 Security\n\nSee [SECURITY.md](SECURITY.md) for reporting vulnerabilities.\n\n## ❓ FAQ\n\n### General\n\n1. **What is Databuddy?**\n   Databuddy is a comprehensive analytics and data management platform.\n\n2. **How do I get started?**\n   Follow the [Getting Started](#getting-started) guide.\n\n3. **Is it free?**\n   Check our [pricing page](https://databuddy.cc/pricing).\n\n### Technical\n\n1. **What are the system requirements?**\n   See [Prerequisites](#prerequisites).\n\n2. **How do I deploy?**\n   See the deployment documentation in our [docs](https://docs.databuddy.cc).\n\n3. **How do I contribute?**\n   See [Contributing](#contributing).\n\n## 💬 Support\n\n- [Documentation](https://docs.databuddy.cc)\n- [Discord](https://discord.gg/JTk7a38tCZ)\n- [Twitter](https://twitter.com/databuddyps)\n- [GitHub Issues](https://github.com/databuddy/databuddy/issues)\n- [Email Support](mailto:support@databuddy.cc)\n\n## 📄 License\n\nThis project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See the [LICENSE](LICENSE) file for details.\n\nCopyright (c) 2025 Databuddy\n\n## 🙏 Acknowledgments\n\nSee [ACKNOWLEDGMENTS.md](ACKNOWLEDGMENTS.md) for credits.\n\n## ⚠️ Coding Standards \u0026 Rules\n\n- **Bun is required** for all development and scripts. Do not use npm, pnpm, or Node.js CLI for install, run, or dev.\n- **Zod v4** (from `zod/v4`) is required everywhere. Do not use Zod v3.\n- **Use only Phosphor icons** (not Lucide).\n- **Use Dayjs** for date handling (never date-fns).\n- **Use Tanstack Query** for hooks (never SWR).\n- **Use rounded** for border radius (never rounded-xl or rounded-md).\n- **Never add placeholders or mock data.**\n- **Always ensure type-safety** and use shared types where possible.\n- **Never throw errors in server actions;** use try/catch and return errors to the client.\n- **Always use error boundaries properly.**\n- **Console usage:** Use `console.error`, `console.time`, `console.json`, `console.table`, etc. appropriately.\n- **Almost never use useEffect** unless critical.\n- **Use Ultracite** for linting and formatting.\n- **Use Prettier** for code formatting.\n\nSee `.cursor/rules/` for the full enforced ruleset.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatabuddy-analytics%2FDatabuddy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatabuddy-analytics%2FDatabuddy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatabuddy-analytics%2FDatabuddy/lists"}