Navigate to the Reportr homepage and click “Sign Up” or “Get Started”.
Reportr uses Google OAuth for authentication via NextAuth.js. Your refresh tokens are securely stored to enable automated data collection.
2
Choose Your Plan
Select a signup flow:
Free Trial
Paid Plan
Start with the FREE plan (no credit card required):
1 client
5 reports per month
14-day trial with full access
Email verification required
After signing up with Google, you’ll receive a verification email. Click the link to unlock your account and start your trial.
Subscribe to STARTER, PROFESSIONAL, or AGENCY:
Immediate access (no email verification)
PayPal subscription required
Choose between trial or direct subscription
White-label features available
PayPal integration uses subscription plans with automatic billing cycles.
3
Sign In with Google
Click the “Sign in with Google” button. Reportr will request the following permissions:
Basic profile information (name, email)
Access to Google Search Console data
Access to Google Analytics 4 data
These permissions enable automated data collection for your reports.
4
Verify Your Email (Free Users Only)
If you chose the FREE plan, check your email for a verification link:
// Email verification is handled server-side// Free users see a banner on the dashboard until verifiedif (signupFlow === 'FREE' && !emailVerified) { // Show verification banner return <EmailVerificationBanner />;}
You cannot add clients or generate reports until your email is verified (FREE plan only). Paid users skip this step.
From the dashboard, click “Manage Clients” or navigate to /dashboard/clients.
2
Create a New Client
Click “Add Client” and fill in the required information:
const clientSchema = z.object({ name: z.string().min(2, 'Name must be at least 2 characters'), domain: z.string().url('Must be a valid URL'), contactName: z.string().optional(), contactEmail: z.string().email('Must be a valid email').optional(),});
Required fields:
Client Name: Your client’s business name (min 2 characters)
Domain: Full website URL (e.g., https://example.com)
Optional fields:
Contact Name: Primary contact person
Contact Email: Client email for notifications
3
Connect Google Services
After creating the client, connect their Google accounts:
Google Search Console
Google Analytics 4
Click “Connect Search Console”
Select the property from the list (or enter manually)
Reportr automatically detects available properties:
// Properties are fetched from the Search Console APIconst sites = await searchconsole.sites.list();// Returns: [{ siteUrl, permissionLevel }]
The system stores the gscSiteUrl for future data fetches.
Click “Connect Google Analytics”
Select the GA4 property from the dropdown
Reportr fetches all available properties:
// Properties are fetched from Analytics Admin APIconst accounts = await analyticsadmin.accounts.list();for (const account of accounts) { const properties = await analyticsadmin.properties.list({ filter: `parent:${account.name}` });}
The system stores the ga4PropertyId (e.g., “123456789”).
Reportr uses your Google OAuth tokens to access these APIs. Tokens are automatically refreshed when they expire.
