Getting started
From signup to your first bichito in five minutes. The happy path with no detours.
This page takes you from "I just heard of bichito" to "my first bug landed in the inbox." It's five steps and assumes nothing.
1. Create your account
Go to bichito.dev/signup and either sign in with Google / GitHub or pick a password. If you go the password route, we'll send a 6-digit verification code to your inbox — paste it on the next screen.
OAuth signups skip email verification entirely. Either way, you land in the onboarding wizard.
2. Name your hive
A hive is your top-level workspace. Most teams have one; companies running unrelated products often have a hive per product. Pick a name you'll recognise — you can rename it later.
3. Create a honeycomb
Inside the hive you create one or more honeycombs, one per project. A honeycomb has its own widget snippet, its own bug inbox, and its own settings (labels, blocklist, allowed origins, notification recipients).
Give it a name and an optional description. When you save, the dashboard surfaces the install snippet for the next step.
4. Drop the widget on your site
Copy the snippet from the install screen and paste it into the page where you want the floating "Report a bug" button to appear.
<script
src="https://bichito-api.fly.dev/widget.js"
data-key="sk_your_project_key"
async
></script>Framework-specific snippets (Next.js, React, Vue, Astro, WordPress) are generated for you in the dashboard with the key already filled in. The full reference is in the Widget page.
5. Send your first report
Visit the page where you pasted the snippet and click the floating button. Fill in the modal, hit Send. Switch back to the dashboard and the bichito appears in /inbox in real time — no refresh needed.
You're set.
What to do next
- Customise the look — see Widget → Theming.
- Plug in your AI assistant — MCP lets Claude Code or Cursor triage bichitos for you.
- Forward reports to Slack or Discord — see Webhooks.
- Save your common filters as one-click views — see Saved views.
Concepts you'll see across the docs
The docs use the same words the dashboard uses:
- Hive — your workspace. Owns the plan and the billing.
- Honeycomb — one project inside a hive. Owns its inbox + widget key.
- Bichito — one bug report. ("Bichito" is Spanish for "little bug".)
- Label — a colored tag you can attach to bichitos.
- Saved view — a named filter combo pinned to your inbox.
Full glossary in Concepts.