Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tariqdev.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
Integrations

Sonata includes optional integrations for real hosting workflows.
Integrations are optional. Sonata should still render without them, but pages that rely on live API data may show fallback states.

​
Pterodactyl Stock

API route: 
app/api/stock/route.ts
Environment variables: 
PTERODACTYL_PANEL_URL=https://panel.example.com
PTERODACTYL_APP_KEY=ptla_xxxxxxxxxxxxxxxxx
Use an Application API key with read access to the required resources. Recommended checks:
  • Panel URL has no trailing slash unless the code expects it.
  • API key is an Application API key, not a client API key.
  • Location IDs match the locations used in product data.
  • Production environment variables match local values.
Never expose the Pterodactyl application key to client-side code.

​
UptimeRobot Status

API route: 
app/api/uptime/route.ts
Environment variable: 
UPTIMEROBOT_API_KEY=ur_xxxxxxxxxxxxxxxxx
Use a Main API Key. If status does not show correctly:
  • Confirm monitors exist.
  • Confirm the API key is active.
  • Check API route logs.
  • Check deployment environment variables.

​
Discord Widget

Environment variable: 
NEXT_PUBLIC_DISCORD_GUILD_ID=000000000000000000
Enable the server widget in Discord settings. Discord setup:
  1. Open Discord server settings.
  2. Enable the server widget.
  3. Copy the server ID.
  4. Set NEXT_PUBLIC_DISCORD_GUILD_ID.
  5. Restart the dev server.

​
Billing

Main billing base URL: 
lib/config/site.ts
Look for: 
billing: {
  url: "https://billing.example.com",
  panel: "https://panel.example.com",
}
Product-specific billing URLs are stored in product data files. Common billing providers:
  • WHMCS.
  • Paymenter.
  • Blesta.
  • WISECP.
  • Custom storefront or checkout.
For game hosting, make sure selected cycle, location, and software values become query parameters your billing panel understands.

​
Domain Lookup

Domain lookup uses public RDAP data. API route: 
app/api/domain-check/route.ts
No API key is required for basic RDAP lookup.

​
Integration Testing

Use this quick flow after changing integration settings:
  1. Restart the dev server.
  2. Open the status page.
  3. Open a game hosting product page.
  4. Check stock badges.
  5. Search for a domain.
  6. Click a billing link.
  7. Check terminal logs for API errors.

​
Anti-Piracy Placeholders

Sonata may include non-visual marketplace placeholders and markers for leak tracing. Do not remove, rename, disable, or tamper with these markers unless you have written permission.