Modern web interface for the Evo CRM Community — built with React, TypeScript and Vite.
Website · Documentation · Community · Support
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.
Built 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.
Evo CRM Frontend is part of the Evo CRM Community ecosystem maintained by Evolution Foundation. To use the full stack, clone the umbrella repository with submodules:
git clone --recurse-submodules [email protected]:evolution-foundation/evo-crm-community.gitThe 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.
| Component | Technology |
|---|---|
| Framework | React 19 |
| Language | TypeScript |
| Build | Vite |
| Routing | React Router 7 |
| Styling | TailwindCSS 4 |
| Design system | @evoapi/design-system |
| Forms | React Hook Form + Zod |
| HTTP | Axios |
| WebSocket | ActionCable |
| State | Zustand |
| i18n | i18next |
| Dates | date-fns |
- Node.js 18+
- pnpm 8+
- Evo CRM Backend (
evo-ai-crm-community) running
git clone [email protected]:evolution-foundation/evo-ai-frontend-community.git
cd evo-ai-frontend-community
# Install dependencies
pnpm install
# Configure environment
cp .env.example .env.local
# Edit .env.local with your settingsSet the API URL in .env.local:
VITE_API_URL=http://localhost:3000pnpm run dev # Dev server with hot reload
pnpm run build # Production build
pnpm run preview # Preview the production buildThe development server runs on http://localhost:5173.
| Script | Description |
|---|---|
pnpm run dev |
Development server with hot reload |
pnpm run build |
Production build |
pnpm run preview |
Preview production build |
pnpm run test |
Run tests with Vitest |
pnpm run test:watch |
Tests in watch mode |
pnpm run test:coverage |
Tests with coverage report |
pnpm run eslint |
Run ESLint |
pnpm run eslint:fix |
Auto-fix ESLint issues |
src/
├── assets/ # Static resources (images, icons)
├── components/ # Reusable components
│ ├── base/ # Custom components (badges, buttons)
│ ├── layout/ # Headers, sidebars, notifications
│ └── ui/ # Design system primitives
├── contexts/ # React contexts (auth, notifications, theme)
├── hooks/ # Custom hooks
├── pages/ # Page components organized by domain
│ ├── Auth/ # Login, registration, recovery
│ ├── Customer/ # Contacts, conversations
│ ├── Admin/ # Administrative area
│ └── Settings/ # System settings
├── routes/ # Route configuration
├── services/ # API services by feature
├── styles/ # Global styles
├── types/ # TypeScript types
├── utils/ # Utilities
└── constants/ # Constants and configuration
Configured in TypeScript and Vite for clean imports:
import { Button } from '@/components/ui/Button';
import { useAuth } from '@/contexts/AuthContext';Aliases: @/components, @/contexts, @/hooks, @/services, @/pages, @/types, @/utils, @/styles, @/assets.
For full code conventions, see CONTRIBUTING.md.
- Bearer token authentication integrated with
evo-auth-service-community - Real-time WebSocket notifications via ActionCable
- Dark/light theme with full design system
- Internationalization (i18n) — EN, PT-BR
- Conversations and chat with WhatsApp, Email, Web Widget channels
- Contacts management with filters, search and infinite scroll
- Channels configuration (WhatsApp, Email, SMS, etc.)
- Reports and analytics dashboards
- Toast notifications and loading states
- Responsive layout with collapsible sidebar
| Resource | Link |
|---|---|
| Website | evolutionfoundation.com.br |
| Documentation | docs.evolutionfoundation.com.br |
| Community | evolutionfoundation.com.br/community |
| Changelog | CHANGELOG.md |
| Contributing | CONTRIBUTING.md |
| Security | SECURITY.md |
Contributions are welcome! Please read CONTRIBUTING.md for guidelines on how to submit issues, propose features, and open pull requests.
Join our community to discuss ideas and collaborate.
For security issues, do not open a public issue. Email [email protected] or use GitHub's private vulnerability reporting. See SECURITY.md for details.
Evo CRM Frontend is licensed under the Apache License 2.0, with additional brand-protection conditions. See LICENSE for details.
"Evolution Foundation", "Evolution" and "Evo CRM Frontend" are trademarks of Evolution Foundation. See TRADEMARKS.md for the brand assets policy.
Third-party attributions are documented in NOTICE.
Made by Evolution Foundation · © 2026