Launch a Developer Product with Docs, Billing, and Feedback

// docs/mint.json — Documentation site configuration
{
  "name": "DataForge API",
  "logo": { "dark": "/logo/dark.svg", "light": "/logo/light.svg" },
  "favicon": "/favicon.svg",
  "colors": { "primary": "#6366F1", "light": "#818CF8", "dark": "#4F46E5" },
  "navigation": [
    {
      "group": "Getting Started",
      "pages": ["introduction", "quickstart", "authentication"]
    },
    {
      "group": "API Reference",
      "pages": [
        "api-reference/overview",
        { "group": "Data Sources", "pages": ["api-reference/sources/list", "api-reference/sources/create", "api-reference/sources/sync"] },
        { "group": "Transforms", "pages": ["api-reference/transforms/run", "api-reference/transforms/schedule"] }
      ]
    },
    { "group": "Guides", "pages": ["guides/webhooks", "guides/rate-limits", "guides/errors"] }
  ],
  "api": {
    "baseUrl": "https://api.dataforge.dev",
    "auth": { "method": "bearer", "name": "API Key" }
  },
  "tabs": [
    { "name": "Docs", "url": "/" },
    { "name": "API Reference", "url": "api-reference" }
  ]
}

// docs/quickstart.mdx — Getting started guide
---
title: "Quickstart"
description: "Start syncing data in under 5 minutes"
---

## Get your API key

Create an account at [dashboard.dataforge.dev](https://dashboard.dataforge.dev) and copy your API key from Settings.

<Note>
  Free tier includes 10,000 API calls/month. No credit card required.
</Note>

## Install the SDK

<CodeGroup>
```bash npm
npm install @dataforge/sdk

pip install dataforge

// src/billing/setup.ts — Create products and pricing on Polar
import { Polar } from "@polar-sh/sdk";

const polar = new Polar({ accessToken: process.env.POLAR_ACCESS_TOKEN });

// Free tier — no payment required
const freePlan = await polar.products.create({
  name: "Free",
  description: "10,000 API calls/month, 1 data source",
  prices: [{ type: "recurring", amount: 0, currency: "usd", interval: "month" }],
});

// Pro tier
const proPlan = await polar.products.create({
  name: "Pro",
  description: "100,000 API calls/month, unlimited sources, priority support",
  prices: [
    { type: "recurring", amount: 4900, currency: "usd", interval: "month" },
    { type: "recurring", amount: 49000, currency: "usd", interval: "year" },
  ],
});

// Enterprise — usage-based
const enterprisePlan = await polar.products.create({
  name: "Enterprise",
  description: "Unlimited calls, $0.001 per call after 500K, SLA, SSO",
  prices: [{ type: "recurring", amount: 29900, currency: "usd", interval: "month" }],
});

// src/billing/middleware.ts — Check subscription in API middleware
import { Polar } from "@polar-sh/sdk";

const polar = new Polar({ accessToken: process.env.POLAR_ACCESS_TOKEN });

async function checkSubscription(apiKey: string): Promise<{
  plan: "free" | "pro" | "enterprise";
  callsRemaining: number;
}> {
  const customer = await getCustomerByApiKey(apiKey);
  const subscription = await polar.subscriptions.list({
    customerId: customer.polarId,
    active: true,
  });

  const plan = subscription.items[0]?.product.name.toLowerCase() || "free";
  const limits = { free: 10_000, pro: 100_000, enterprise: Infinity };

  const usage = await getMonthlyUsage(customer.id);
  return {
    plan: plan as any,
    callsRemaining: limits[plan] - usage,
  };
}

# Move from .env files to centralized secrets
infisical init --project=dataforge

# Import existing secrets
infisical secrets set \
  DATABASE_URL="postgresql://..." \
  POLAR_ACCESS_TOKEN="pat_xxx" \
  FORMBRICKS_API_KEY="fbk_xxx" \
  --env=production

# Development
infisical secrets set \
  DATABASE_URL="postgresql://localhost/dataforge_dev" \
  --env=development

# Update your start scripts
# Before: source .env && npm start
# After:
infisical run --env=production -- npm start

// src/dashboard/feedback.tsx — Collect feedback at the right moments
import formbricks from "@formbricks/js/app";

// Initialize on dashboard load
formbricks.init({
  environmentId: process.env.NEXT_PUBLIC_FORMBRICKS_ENV_ID!,
  apiHost: "https://feedback.dataforge.dev",
});

// After first successful sync — ask about onboarding experience
function SyncSuccess({ syncResult }) {
  useEffect(() => {
    if (syncResult.isFirstSync) {
      formbricks.track("first_sync_completed", {
        sourceType: syncResult.sourceType,
        rowCount: syncResult.rowCount,
      });
    }
  }, []);
  // ...
}

// After 30 days — NPS survey
function DashboardLayout({ user }) {
  useEffect(() => {
    formbricks.setUserId(user.id);
    formbricks.setAttributes({
      plan: user.plan,
      signupDate: user.createdAt,
      totalSyncs: user.totalSyncs,
    });
  }, []);
  // ...
}