LaLeV/wacrm
1
0
Fork 0
mirror of https://github.com/Luchexx/wacrm.git synced 2026-11-02 17:29:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
3e06698847
wacrm/docs
History
Arnas Donauskas 1f2849df75
Merge remote-tracking branch 'origin/main' into chore/whatsapp-trademark-symbol 
# Conflicts:
#	README.md
#	docs/README.md
#	docs/automations-and-cron.md
#	docs/supabase-setup.md
#	docs/whatsapp-setup.md
#	src/app/opengraph-image.tsx
#	src/components/landing/hero.tsx
#	src/lib/seo/site-config.ts
2026-05-06 13:50:03 +03:00
..
architecture.md chore: add WhatsApp® on first mention across user-facing surfaces 2026-05-06 12:13:26 +03:00
automations-and-cron.md Merge remote-tracking branch 'origin/main' into chore/whatsapp-trademark-symbol 2026-05-06 13:50:03 +03:00
deployment-hostinger.md Merge remote-tracking branch 'origin/main' into chore/whatsapp-trademark-symbol 2026-05-06 13:50:03 +03:00
environment-variables.md chore: add WhatsApp® on first mention across user-facing surfaces 2026-05-06 12:13:26 +03:00
getting-started.md Merge remote-tracking branch 'origin/main' into chore/whatsapp-trademark-symbol 2026-05-06 13:50:03 +03:00
README.md Merge remote-tracking branch 'origin/main' into chore/whatsapp-trademark-symbol 2026-05-06 13:50:03 +03:00
supabase-setup.md Merge remote-tracking branch 'origin/main' into chore/whatsapp-trademark-symbol 2026-05-06 13:50:03 +03:00
troubleshooting.md Merge remote-tracking branch 'origin/main' into chore/whatsapp-trademark-symbol 2026-05-06 13:50:03 +03:00
whatsapp-setup.md Merge remote-tracking branch 'origin/main' into chore/whatsapp-trademark-symbol 2026-05-06 13:50:03 +03:00

README.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

  1. Getting started — fork the repo, install, run locally.
  2. Supabase setup — create the database, run the migrations, grab the keys.
  3. WhatsApp setup — create a Meta app, connect a phone number, wire the webhook.
  4. Environment variables — the full reference.

Deploy

  1. Deploy on Hostinger — Managed Node.js Hosting walkthrough, the recommended way to ship the template.
  2. Automations cron — schedule the pending executions drain so waits and delays fire.

Reference

  1. Architecture — stack, folder layout, request lifecycle, where to change things.
  2. 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.