Analytics

Built-in analytics for every published Proyecta app. Open Admin > Analytics in the builder to see traffic, Web Vitals, and device breakdowns.

Every Proyecta app ships with analytics. There is nothing to install, no snippet to paste, and no third-party account required. Data collection runs on every published app; the in-builder analytics dashboard is available on the Pro plan and above. Open Admin > Analytics in the builder to view data from your published site.

The three views

Analytics has three views, listed in the admin sidebar:

View	What it shows
Overview	Traffic — page views, visitors, sessions, top pages, and a daily time-series chart (referrers appear in the Devices tab)
Web Vitals	Core Web Vitals (LCP, INP, CLS) captured from real users
Devices	Browsers and traffic sources (referrers)

What data is tracked?

Analytics are collected automatically from your published site (your *.proyecta.live subdomain or your custom domain). Preview traffic inside the builder is not counted.

The current window is the last 7 days. A configurable date range picker is on the roadmap.

How do I access it?

Open your project in the builder, switch to the Admin view, then choose Analytics in the sidebar. Viewing it requires a Pro plan or above — on the Free plan it shows an upgrade prompt instead. On a paid plan the Overview loads by default; use the sidebar to jump between Overview, Web Vitals, and Devices.

Track custom events

Beyond the automatic pageview and Web Vitals collection, your app can record its own custom events — signups, purchases, feature usage, whatever matters to you. Custom events are attributed to your app automatically.

Your app already ships with the tracker wired up, so you just call track() from anywhere in your React code:

import { track } from '@proyecta-ai/analytics';

// Fire from an event handler, an effect, or right after a successful write.
track('signup', { plan: 'pro', referrer: 'newsletter' });

track('add_to_cart', { sku: 'ABC-1' });
track('checkout', { total: 49 });

Properties are a flat object of strings and numbers. track() never throws and needs no null check — if analytics hasn’t initialized yet the call is simply dropped, so it is safe to call during render or on first paint.

Ask the AI to wire this up: "Track a 'signup' event whenever a new user registers."

FAQ

Do I need to add Google Analytics or Mixpanel?

No. Analytics are built in and enabled automatically for every published app. If you want a third-party provider in addition, you can still ask the AI to integrate one — add your provider’s API key in the Environment Variables section of the Settings page and say "Add Google Analytics to my app".

Do I need a paid plan?

Collection runs on every published app regardless of plan. The Analytics section in Admin is a Pro feature — on the Free plan it shows an upgrade prompt. Custom-event tracking works on any plan.

Why don’t I see any data?

Analytics only track the published version of your app. If you haven’t published yet, or if your published site hasn’t had traffic in the last 7 days, the panel will be empty. Preview traffic inside the builder is not counted. (Also make sure you’re on a Pro plan — the dashboard itself is Pro-gated.)

Can I export the data?

Not yet. CSV export is on the roadmap.

Can I pick a different date range?

Not yet. The panel shows the last 7 days. Custom ranges are on the roadmap.

Is visitor data anonymized?

Proyecta analytics use a first-party cookie (_pry_vid) to identify returning visitors. They do not track users across third-party sites. Whether you need a cookie consent banner depends on your users’ jurisdiction (e.g. GDPR in the EU may require consent for persistent identifiers). Consult your legal counsel.

Coming soon

• Configurable date ranges (24h, 30d, custom)
• CSV export
• Conversion and goal tracking