FAQ
Answers to common questions about how SaasGotchi works, what we track, and what we don't. HOW IT WORKS →
GIT & PRIVACY
Q: What exactly does SaasGotchi read from my GitHub / GitLab account?
A: Only the commit history of the single repo you choose during onboarding. We check whether you pushed at least one commit on a given calendar day — that's it. We do not read your code, your issues, your PRs, your private repos, or any repo other than the one you selected.
Q: Can I change or disconnect my repo later?
A: Yes. From your dashboard settings you can swap the connected repo or remove the integration entirely. Removing it means commit days are no longer counted; activity will only be tracked via page visitors.
Q: Do you store my GitHub / GitLab access token?
A: We store an OAuth token scoped to read-only repository access — the minimum required to count commit days. Tokens are encrypted at rest. You can revoke access at any time from your GitHub / GitLab account settings.
Q: What if I don't want to connect a repo at all?
A: No problem — it's optional. Activity will be tracked via page visitors only (from the tracker snippet on your product landing page). Streak and health score still work, just without commit days.
Q: Do you track anything else from my GitHub account — stars, followers, issues?
A: No. We only count: "did this user push at least one commit to this specific repo today?" That single boolean is all we pull per day. No stars, no watchers, no issue counts, no contributor data.
HEALTH & STATUS
Q: How is the health score calculated?
A: The score runs from 0 to 100 and updates daily:
+5 pts day with at least one unique page visitor+3 pts day with at least one commit in your linked repo+10 pts new MRR milestone hit−5 pts day with zero activity (no visitors, no commits)
Score is capped at 100 and cannot go below 0.
Q: What's the difference between status and the animation?
A: Status (healthy / sleepy / sick / evolving / dead) reflects the overall health score and inactivity streak. The animation reflects today's activity — a HEALTHY gotchi with no visitors yet today will do a slow idle bob; once a visitor lands it switches to the happy bounce automatically.
Q: My gotchi is HEALTHY but just sitting there. Is something broken?
A: Nope. HEALTHY + no visitors today = idle slow bob. HEALTHY + at least one visitor today = happy bounce with sparkles. The animation updates in real-time as activity comes in.
Q: How long does it take for status to change after I get activity?
A: The health score and status are recalculated once per day by the background system. Real-time activity (visitor today / commit today) is reflected immediately in the animation but the status label and health number update on the next daily run.
Q: Can a dead gotchi come back to life?
A: Yes. Get at least one unique visitor or push a commit. On the next daily update the gotchi revives to SICK, then climbs back toward HEALTHY as the streak builds. MRR updates also trigger a health boost.
EVOLUTION & LEVELS
Q: Does my gotchi evolve automatically?
A: Yes — no manual action required. Evolution is checked daily. The moment your cumulative unique visitors or MRR crosses the next threshold, the gotchi enters EVOLVING status for ~24 hours then levels up permanently.
Q: What are the evolution thresholds?
A: Each level requires either the visitor threshold or the MRR threshold — not both:
EGG → BABY 10+ unique visitors or $1 MRRBABY → KID 100+ unique visitors or $50 MRRKID → TEEN 500+ unique visitors or $200 MRRTEEN → ADULT 2,000+ unique visitors or $1,000 MRRADULT → LEGEND 10,000+ unique visitors or $5,000 MRR
Q: Can a gotchi de-evolve if I lose visitors or MRR?
A: No. Evolution is permanent — once a level is reached it is never taken away. Your gotchi can get sick or die from inactivity, but it keeps its visual form.
Q: What counts as "unique visitors"?
A: Unique visitors are tracked via the snippet you install on your product landing page. Each distinct browser session counts once per day. Bot traffic is filtered. Cumulative unique visitors across all time is what drives evolution — not daily unique visitors.
STREAK
Q: What counts as an active day for streak purposes?
A: At least one unique visitor to your gotchi's public page OR at least one commit to your linked repo (if connected). Either one is enough — you don't need both.
Q: If I miss a day, does my whole streak reset?
A: Yes. Missing a full calendar day (UTC) with zero activity resets your streak to 0. The streak counter shows consecutive days, not total active days.
Q: Does the streak affect health score or evolution?
A: Not directly — but a long streak means you're earning daily health points regularly, which keeps your score high. Streak milestones (3d, 7d, 30d) are displayed as badges but don't grant bonus points.
TRACKER SNIPPET & PRIVACY
Q: What does the tracker snippet collect?
A: A page view event (timestamp + gotchi ID). No personal data, no cookies, no cross-site tracking. It only tells us "someone visited this page today" — not who.
Q: Does the tracker affect my page's performance or SEO?
A: The snippet is a tiny async script that fires after page load. It has no effect on Core Web Vitals, LCP, or SEO. It is excluded from search engine crawl detection.
Q: Can I install the tracker on multiple pages?
A: Yes, but all views funnel into a single gotchi — whichever gotchi ID is in the snippet. If you want to track different products separately, each needs its own SaasGotchi account and snippet.
ACCOUNT & DATA
Q: How do I delete my account and data?
A: From your dashboard settings → Danger Zone → Delete Account. This permanently removes your gotchi, all activity history, and revokes any OAuth tokens. This cannot be undone.
Q: Is my MRR data shared or visible to others?
A: Only if you choose to display it. MRR is shown on your public gotchi page by default, but you can hide it from Settings. The exact figure is only visible to you in your dashboard — the public page shows it rounded to the nearest $100 if you've enabled display.
Q: Can I have multiple gotchis (multiple products)?
A: Not currently — one gotchi per account. Multi-product support is on the roadmap.