wacrm/docs/README.md
Arnas Donauskas 029a20e407
fix(hostinger): recommend Managed Node.js Hosting, not VPS
Swaps the Hostinger recommendation on the landing page and throughout the
docs from VPS to Managed Node.js Hosting
(https://www.hostinger.com/web-apps-hosting).

The deploy walkthrough is rewritten around hPanel's Node.js app flow
(Git-based deploy, env vars panel, AutoSSL, cron via Advanced → Cron Jobs)
instead of a raw Ubuntu VPS with nginx + PM2 + certbot. VPS stays
mentioned at the bottom of the deploy page as an alternative when a
user actually needs one (background workers, custom binaries, etc.).

Also touched:
  - docs/README.md, environment-variables.md, automations-and-cron.md,
    troubleshooting.md to drop VPS-specific assumptions.
  - footer link URL.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-19 21:02:10 +03:00

44 lines
1.9 KiB
Markdown

# WaCRM documentation
WaCRM is a self-hostable WhatsApp CRM built on Next.js and Supabase. These
docs walk you from a freshly forked repo to a production deploy.
## Reading order
1. **[Getting started](./getting-started.md)** — fork the repo, install, run
locally.
2. **[Supabase setup](./supabase-setup.md)** — create the database, run the
migrations, grab the keys.
3. **[WhatsApp setup](./whatsapp-setup.md)** — create a Meta app, connect a
phone number, wire the webhook.
4. **[Environment variables](./environment-variables.md)** — the full reference.
5. **[Deploy on Hostinger](./deployment-hostinger.md)** — recommended hosting
walkthrough (Managed Node.js Hosting).
6. **[Automations cron](./automations-and-cron.md)** — schedule the pending
executions drain so waits and delays fire.
7. **[Troubleshooting](./troubleshooting.md)** — the usual suspects.
## What you will need before starting
- A GitHub account (to fork the repo).
- A [Supabase](https://supabase.com) project on any paid or free tier.
- A [Meta for Developers](https://developers.facebook.com) 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](https://www.hostinger.com/web-apps-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-CBC for per-user access tokens.
- **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>.