engageplus

Zero-friction authentication setup for developers. One command to get EngagePlus authentication running in any web project — designed for vibe coding with AI assistants like Cursor.

Quick Start

npx engageplus init

That's it. The CLI will:

1. Open your browser — sign in with GitHub, Google, or any provider
2. Create an organization — or select an existing one
3. Generate an API key — full management API access
4. Register your redirect URI — http://localhost:PORT/callback
5. Write config files:
   • .env.local — credentials for your app
   • .cursor/rules/engageplus.mdc — AI agent instructions

Usage

# Interactive setup (shows login widget)
npx engageplus init

# Auto-login with a specific provider
npx engageplus init --github
npx engageplus init --google
npx engageplus init --microsoft

What Gets Written

.env.local

ENGAGEPLUS_ORG_ID=your_org_id
ENGAGEPLUS_API_KEY=epk_your_key
ENGAGEPLUS_API_BASE=https://api.engageplus.id
ENGAGEPLUS_AUTH_BASE=https://auth.engageplus.id

.cursor/rules/engageplus.mdc

A comprehensive rule file that teaches your AI assistant how to:

• Add the EngagePlus login widget to any framework (React, Vue, Svelte, vanilla JS)
• Handle OAuth callbacks
• Configure authentication providers via the Management API
• Set up webhooks for auth events
• Connect Supabase or Airtable for user data sync
• Customize the widget theme and branding

After Setup

Just tell your AI assistant what you need:

• "Add a login page to my app"
• "Set up Google and GitHub authentication"
• "Connect my Supabase database to sync user data"
• "Add a webhook to notify my backend on login"

The AI reads .cursor/rules/engageplus.mdc and knows your org ID, API key, and how to use every EngagePlus API.

Requirements

• Node.js 18+
• A browser (for the one-time authentication step)

How It Works

┌─────────────┐     ┌──────────────┐     ┌──────────────────┐
│  Your CLI    │────▶│  Browser     │────▶│  EngagePlus Auth  │
│  (terminal)  │◀────│  (localhost) │◀────│  (OIDC/OAuth)     │
└──────┬───────┘     └──────────────┘     └──────────────────┘
       │
       ▼
┌──────────────┐     ┌──────────────────┐
│  Create Org  │────▶│  Generate API Key │
└──────┬───────┘     └────────┬─────────┘
       │                      │
       ▼                      ▼
  .env.local         .cursor/rules/engageplus.mdc

The CLI starts a temporary local server, opens your browser for authentication, receives the tokens, then uses them to set up your organization and API key. All credentials are written to local files — nothing is stored externally.

Links

• Documentation
• Management API Reference
• Dashboard
• For AI Agents