> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudgra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nudgra Cloud overview

> Understand the Next.js and Convex Cloud distribution of Nudgra.

Nudgra Cloud is the hosted-backend distribution of Nudgra. You host the Next.js dashboard, and Convex Cloud owns backend state, auth, scheduling, and Meta webhook handling.

Use this distribution when you want less infrastructure to operate yourself.

<Card title="View Nudgra Cloud on GitHub" icon="github" href="https://github.com/MaikoCode/nudgra-cloud">
  Open the Next.js and Convex source repository.
</Card>

## Stack

* Next.js 16.
* React 19.
* Convex.
* Convex Auth.
* Tailwind CSS 4.
* `shadcn` UI components.

## What you need

For local development:

* Git.
* Node.js 24 or newer.
* A Convex account.
* A Google account.
* A Meta Developer account.
* An Instagram professional account.

For production:

* A Vercel project for the Next.js app.
* A Convex production deployment.
* A public domain or subdomain for the Next.js app.

## Important URLs

Replace `https://your-app-domain.com` with your public app domain.

Replace `https://your-convex-site.convex.site` with the Convex HTTP Actions URL for your deployment.

| Purpose                   | URL                                                             |
| ------------------------- | --------------------------------------------------------------- |
| App                       | `https://your-app-domain.com`                                   |
| Google OAuth redirect URI | `https://your-convex-site.convex.site/api/auth/callback/google` |
| Meta OAuth redirect URI   | `https://your-app-domain.com/api/meta/callback`                 |
| Meta webhook callback URL | `https://your-convex-site.convex.site/meta/webhooks`            |
| Convex dashboard          | `npx convex dashboard`                                          |

<Warning>
  Meta webhooks must point to the Convex site URL, not the Next.js app URL. The webhook route is defined in `convex/http.ts` at `/meta/webhooks`.
</Warning>

## Setup path

1. Run [local development](/cloud/local-development).
2. Configure [environment variables](/cloud/environment-variables).
3. Configure [Google OAuth](/shared/google-oauth).
4. Configure [Meta / Instagram setup](/shared/meta-instagram-setup).
5. Deploy to [Vercel and Convex](/cloud/deploy-vercel-convex).