{"id":49957425,"url":"https://github.com/evolution-foundation/evo-ai-frontend-community","last_synced_at":"2026-05-28T00:01:33.426Z","repository":{"id":351872999,"uuid":"1185629133","full_name":"evolution-foundation/evo-ai-frontend-community","owner":"evolution-foundation","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-25T16:50:25.000Z","size":8247,"stargazers_count":7,"open_issues_count":7,"forks_count":23,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-25T17:26:01.463Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evolution-foundation.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-18T19:32:38.000Z","updated_at":"2026-05-25T16:24:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/evolution-foundation/evo-ai-frontend-community","commit_stats":null,"previous_names":["evolutionapi/evo-ai-frontend-community","evolution-foundation/evo-ai-frontend-community"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/evolution-foundation/evo-ai-frontend-community","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-ai-frontend-community","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-ai-frontend-community/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-ai-frontend-community/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-ai-frontend-community/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evolution-foundation","download_url":"https://codeload.github.com/evolution-foundation/evo-ai-frontend-community/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-ai-frontend-community/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33588345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"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":[],"created_at":"2026-05-18T00:18:52.469Z","updated_at":"2026-05-28T00:01:33.420Z","avatar_url":"https://github.com/evolution-foundation.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://evolutionfoundation.com.br\"\u003e\n    \u003cimg src=\"./public/hover-evolution.png\" alt=\"Evolution Foundation\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eEvo CRM Frontend\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Modern web interface for the Evo CRM Community — built with React, TypeScript and Vite.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/evolution-foundation/evo-ai-frontend-community/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/evolution-foundation/evo-ai-frontend-community?include_prereleases\u0026label=version\u0026color=00ffa7\" alt=\"Latest version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\" alt=\"License: Apache 2.0\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://docs.evolutionfoundation.com.br\"\u003e\u003cimg src=\"https://img.shields.io/badge/Docs-evolutionfoundation.com.br-00ffa7\" alt=\"Documentation\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://evolutionfoundation.com.br/community\"\u003e\u003cimg src=\"https://img.shields.io/badge/Community-Join%20us-white\" alt=\"Community\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://evolutionfoundation.com.br\"\u003eWebsite\u003c/a\u003e \u0026middot;\n  \u003ca href=\"https://docs.evolutionfoundation.com.br\"\u003eDocumentation\u003c/a\u003e \u0026middot;\n  \u003ca href=\"https://evolutionfoundation.com.br/community\"\u003eCommunity\u003c/a\u003e \u0026middot;\n  \u003ca href=\"mailto:suporte@evofoundation.com.br\"\u003eSupport\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## About\n\n**Evo CRM Frontend** is the web interface of the Evo CRM Community — a modern React application providing the full user experience for conversations, contacts, agents, channels, automations, reports, and settings.\n\nBuilt with React 19, TypeScript, Vite, TailwindCSS 4 and an in-house design system, it delivers a fast, accessible, dark-mode-first experience aligned with the Evo CRM visual identity.\n\n## Part of the Evo CRM Community\n\nEvo CRM Frontend is part of the [Evo CRM Community](https://github.com/evolution-foundation/evo-crm-community) ecosystem maintained by Evolution Foundation. To use the full stack, clone the umbrella repository with submodules:\n\n```bash\ngit clone --recurse-submodules git@github.com:evolution-foundation/evo-crm-community.git\n```\n\nThe Community Edition is **single-tenant** by design — one account, no multi-tenancy overhead, no super-admin, no billing or plans. All limits are removed and features are unlocked by default.\n\n---\n\n## Tech Stack\n\n| Component | Technology |\n|---|---|\n| Framework | React 19 |\n| Language | TypeScript |\n| Build | Vite |\n| Routing | React Router 7 |\n| Styling | TailwindCSS 4 |\n| Design system | `@evoapi/design-system` |\n| Forms | React Hook Form + Zod |\n| HTTP | Axios |\n| WebSocket | ActionCable |\n| State | Zustand |\n| i18n | i18next |\n| Dates | date-fns |\n\n---\n\n## Quick Start\n\n### Prerequisites\n\n- **Node.js** 18+\n- **pnpm** 8+\n- **Evo CRM Backend** (`evo-ai-crm-community`) running\n\n### Installation\n\n```bash\ngit clone git@github.com:evolution-foundation/evo-ai-frontend-community.git\ncd evo-ai-frontend-community\n\n# Install dependencies\npnpm install\n\n# Configure environment\ncp .env.example .env.local\n# Edit .env.local with your settings\n```\n\nSet the API URL in `.env.local`:\n\n```env\nVITE_API_URL=http://localhost:3000\n```\n\n### Running\n\n```bash\npnpm run dev          # Dev server with hot reload\npnpm run build        # Production build\npnpm run preview      # Preview the production build\n```\n\nThe development server runs on `http://localhost:5173`.\n\n---\n\n## Available Scripts\n\n| Script | Description |\n|---|---|\n| `pnpm run dev` | Development server with hot reload |\n| `pnpm run build` | Production build |\n| `pnpm run preview` | Preview production build |\n| `pnpm run test` | Run tests with Vitest |\n| `pnpm run test:watch` | Tests in watch mode |\n| `pnpm run test:coverage` | Tests with coverage report |\n| `pnpm run eslint` | Run ESLint |\n| `pnpm run eslint:fix` | Auto-fix ESLint issues |\n\n---\n\n## Architecture\n\n### Project structure\n\n```\nsrc/\n├── assets/           # Static resources (images, icons)\n├── components/       # Reusable components\n│   ├── base/         # Custom components (badges, buttons)\n│   ├── layout/       # Headers, sidebars, notifications\n│   └── ui/           # Design system primitives\n├── contexts/         # React contexts (auth, notifications, theme)\n├── hooks/            # Custom hooks\n├── pages/            # Page components organized by domain\n│   ├── Auth/         # Login, registration, recovery\n│   ├── Customer/     # Contacts, conversations\n│   ├── Admin/        # Administrative area\n│   └── Settings/     # System settings\n├── routes/           # Route configuration\n├── services/         # API services by feature\n├── styles/           # Global styles\n├── types/            # TypeScript types\n├── utils/            # Utilities\n└── constants/        # Constants and configuration\n```\n\n### Path aliases\n\nConfigured in TypeScript and Vite for clean imports:\n\n```typescript\nimport { Button } from '@/components/ui/Button';\nimport { useAuth } from '@/contexts/AuthContext';\n```\n\nAliases: `@/components`, `@/contexts`, `@/hooks`, `@/services`, `@/pages`, `@/types`, `@/utils`, `@/styles`, `@/assets`.\n\nFor full code conventions, see [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n---\n\n## Features\n\n- Bearer token authentication integrated with `evo-auth-service-community`\n- Real-time WebSocket notifications via ActionCable\n- Dark/light theme with full design system\n- Internationalization (i18n) — EN, PT-BR\n- Conversations and chat with WhatsApp, Email, Web Widget channels\n- Contacts management with filters, search and infinite scroll\n- Channels configuration (WhatsApp, Email, SMS, etc.)\n- Reports and analytics dashboards\n- Toast notifications and loading states\n- Responsive layout with collapsible sidebar\n\n---\n\n## Documentation\n\n| Resource | Link |\n|---|---|\n| Website | [evolutionfoundation.com.br](https://evolutionfoundation.com.br) |\n| Documentation | [docs.evolutionfoundation.com.br](https://docs.evolutionfoundation.com.br) |\n| Community | [evolutionfoundation.com.br/community](https://evolutionfoundation.com.br/community) |\n| Changelog | [CHANGELOG.md](./CHANGELOG.md) |\n| Contributing | [CONTRIBUTING.md](./CONTRIBUTING.md) |\n| Security | [SECURITY.md](./SECURITY.md) |\n\n---\n\n## Contributing\n\nContributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on how to submit issues, propose features, and open pull requests.\n\nJoin our [community](https://evolutionfoundation.com.br/community) to discuss ideas and collaborate.\n\n---\n\n## Security\n\nFor security issues, **do not open a public issue**. Email **suporte@evofoundation.com.br** or use GitHub's private vulnerability reporting. See [SECURITY.md](./SECURITY.md) for details.\n\n---\n\n## License\n\nEvo CRM Frontend is licensed under the Apache License 2.0, with additional brand-protection conditions. See [LICENSE](./LICENSE) for details.\n\n## Trademarks\n\n\"Evolution Foundation\", \"Evolution\" and \"Evo CRM Frontend\" are trademarks of Evolution Foundation. See [TRADEMARKS.md](./TRADEMARKS.md) for the brand assets policy.\n\nThird-party attributions are documented in [NOTICE](./NOTICE).\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made by \u003ca href=\"https://evolutionfoundation.com.br\"\u003eEvolution Foundation\u003c/a\u003e · © 2026\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolution-foundation%2Fevo-ai-frontend-community","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevolution-foundation%2Fevo-ai-frontend-community","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolution-foundation%2Fevo-ai-frontend-community/lists"}