mirror of
https://github.com/Luchexx/wacrm.git
synced 2026-11-02 09:19:51 +00:00
Drops the "WaCRM" branded name across user-facing surfaces in favour
of a descriptive name. Branded names that imply WhatsApp ownership or
sponsorship are a trademark fair-use risk; a relationship-based name
("CRM Template for WhatsApp") sidesteps that.
Scope:
- Brand text in nav, sidebar, footer, docs shell, mock window chrome.
- SITE_NAME / SITE_DESCRIPTION / legalName in src/lib/seo/site-config.ts.
- README, CONTRIBUTING, docs/, .github/ templates and policies.
- package.json description.
- Auth pages, settings copy, FAQ, code comments.
Out of scope (intentionally — these are infra renames the project
owner should drive separately so links and the package lockfile stay
consistent):
- The github.com/ArnasDon/wacrm repo URL.
- The wacrm.tech domain / homepage field.
- The package.json "name" field.
- The Hostinger application name and Meta system-user name in deploy
docs (existing-deployment instructions).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
||
|---|---|---|
| .. | ||
| architecture.md | ||
| automations-and-cron.md | ||
| deployment-hostinger.md | ||
| environment-variables.md | ||
| getting-started.md | ||
| README.md | ||
| supabase-setup.md | ||
| troubleshooting.md | ||
| whatsapp-setup.md | ||
Documentation
A self-hostable CRM template for WhatsApp built on Next.js and Supabase. These docs walk you from a freshly forked repo to a production deploy.
Reading order
Setup
- Getting started — fork the repo, install, run locally.
- Supabase setup — create the database, run the migrations, grab the keys.
- WhatsApp setup — create a Meta app, connect a phone number, wire the webhook.
- Environment variables — the full reference.
Deploy
- Deploy on Hostinger — Managed Node.js Hosting walkthrough, the recommended way to ship the template.
- Automations cron — schedule the pending executions drain so waits and delays fire.
Reference
- Architecture — stack, folder layout, request lifecycle, where to change things.
- Troubleshooting — the usual suspects.
What you will need before starting
- A GitHub account (to fork the repo).
- A Supabase project on any paid or free tier.
- A Meta for Developers account with a WhatsApp Business app.
- A WhatsApp phone number that is not already tied to the regular WhatsApp or WhatsApp Business mobile apps.
- A Hostinger Managed Node.js Hosting plan (or any Node host that runs long-running Node.js 20+ processes).
Stack at a glance
- Frontend / API — Next.js 16 (App Router), React 19, Tailwind v4.
- Database + auth + storage — Supabase (Postgres + RLS).
- WhatsApp transport — Meta Cloud API (official WhatsApp Business API).
- Encryption — AES-256-GCM for per-user WhatsApp access + verify tokens at rest. Legacy CBC-encrypted rows self-heal on next use.
- Scheduler — cron (or any pinger) that hits
GET /api/automations/cron.
Getting help
If something is unclear or broken, open an issue against the source repo: https://github.com/ArnasDon/wacrm/issues.