Dashboard

The reviewed Ethio Viral cross-browser package is live for Chromium, Kiwi, Firefox, and Safari Web Extensions. Do not share quarantined legacy archives; use the current package from lovable.ethio-viral.com. Native Safari distribution still requires Apple signing.

1. Open lovable.dev and sign in to your Lovable account.
2. Click the extension icon in your browser toolbar to open its panel.
3. Paste the license key you received (for example, ETHIO-EXAMPLE-KEY) and click Activate.
4. Once activated, the panel shows the verified plan and expiry returned by the licensing service; it does not intercept pages or browser sessions.
5. Your license works on a limited number of devices — if you hit the limit, ask your license provider to raise it or revoke an old device.

The extension works on top of Lovable's own security and billing checks, so users may occasionally run into one of the four errors below. None of them is a problem with the license, and each takes under a minute to fix. Share these fixes with your customers — the same guide is public at lovable.ethio-viral.com.

Lovable occasionally asks for extra human verification. While the extension is active, that captcha cannot be displayed, so prompts fail with the error popup shown below (status 428, captcha_required). Apply any one of the fixes to get going again.

{
  "status": 428,
  "type": "captcha_required",
  "title": "Additional verification is required. Please complete the captcha and try again.",
  "message": "Additional verification is required. Please complete the captcha and try again.",
  "details": "",
  "request_id": "1c7da7117f914eda6af9c40311b5be7e"
}

The extension needs at least 1 credit in your active Lovable workspace to operate. Lovable gives every account 5 free credits per day, and those same credits work with the extension. If the workspace balance reaches 0, prompts fail with the error popup shown below (status 402, Payment required).

{
  "status": 402,
  "type": "Payment required",
  "title": "Workspace out of credits",
  "message": "Workspace out of credits",
  "details": "",
  "request_id": "f4cc62012220ccfcca593137fa186484"
}

When you create a new project through the extension, Lovable's fraud protection sometimes flags the request as suspicious — usually because of your IP address — and blocks it with the error popup shown below (status 403, castle_denied). Your account is fine; apply any one of the fixes.

{
  "status": 403,
  "type": "castle_denied",
  "title": "Project creation was blocked due to suspicious activity. Contact support if you believe this is a mistake.",
  "message": "Project creation was blocked due to suspicious activity. Contact support if you believe this is a mistake.",
  "details": "",
  "request_id": "015bf371ce7f1604c59be2fec1501523"
}

If prompts suddenly fail with the red message shown below (status 401, unauthorized — "Invalid token"), the extension's session token has expired or become invalid. This is the quickest error to fix — a single reload clears it.

{
  "status": 401,
  "type": "unauthorized",
  "title": "Invalid token",
  "message": "Invalid token",
  "details": "",
  "request_id": "fa8feffa8088ba8a7e0e8afe8..."
}

License manager access

Manager accounts are not enabled in this release. No manager password is collected.

Account profile & security settings

Update the display name and support handles used by your branded extension.

Create keys for external license generation. API base: https://lovable.ethio-viral.com

License Generation API Docs

Use the reseller API key you created above: Authorization: Bearer YOUR_RESELLER_API_KEY or X-API-Key: YOUR_RESELLER_API_KEY.

POST https://lovable.ethio-viral.com/api/v1/reseller/licenses

Headers:
  Authorization: Bearer YOUR_RESELLER_API_KEY
  Content-Type: application/json

Body fields:
  plan: "trial" or "pro"
  duration_value: duration number
  duration_unit: "minute", "hour", "day", "week", or "month"
  max_activations: allowed devices, 1–50

curl -X POST "https://lovable.ethio-viral.com/api/v1/reseller/licenses" \
  -H "Authorization: Bearer YOUR_RESELLER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan":"trial","duration_value":30,"duration_unit":"minute","max_activations":1}'

curl -X POST "https://lovable.ethio-viral.com/api/v1/reseller/licenses" \
  -H "Authorization: Bearer YOUR_RESELLER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan":"pro","duration_value":30,"duration_unit":"day","max_activations":5}'

{
  "ok": true,
  "license_key": "ETHIO-EXAMPLE-KEY",
  "plan": "Pro",
  "expires_at": "2026-07-01T00:00:00.000Z",
  "duration_minutes": 43200
}