Getting started with REVETOOL

REVETOOL is the AI-powered review workspace for product teams. This guide walks you through your first project end-to-end: workspace setup, project creation, connecting your first integration, importing your first screens, and running your first AI review.

1. Create your workspace

After sign-in, REVETOOL prompts you to create a workspace. A workspace is your top-level container: it holds projects, members, connector credentials and AI settings.

1. Pick a name (your company or team name works well).
2. Choose a slug — this becomes part of internal URLs.
3. Click Create workspace.

2. Create your first project

Inside the workspace, click New project. A project is a self-contained product context with its own screens, tickets, specs, connectors and permissions.

1. Name the project (the product or app you are reviewing).
2. Pick a default environment (Design / Dev / Test / Prod).
3. Invite the first members by email — pick role per member.

3. Connect your first integration

REVETOOL is connector-first. The fastest way to bring real screens in is to connect Figma. Head to the Connectors page in your workspace settings.

• Figma OAuth (recommended for design-led teams)
• GitHub OAuth (recommended for dev-led teams)
• Notion OAuth (recommended for PMs / spec-led teams)
• Vercel PAT (recommended for staging review)

Each connector stores its token encrypted server-side (AES-256-GCM). You can revoke at any time.

4. Import your first screens

Once Figma is connected, open your project and click Add a screen. You have four options:

1. URL — paste a Figma frame URL, REVETOOL extracts the file key and node ID.
2. Image — upload a PNG/JPG mockup (up to 5 MB).
3. HTML — paste raw HTML or upload an HTML file.
4. Existing — pick a screen already in another project.

5. Run your first AI review

Open the screen in the Review surface. On the right panel, you will find Reco with AI. Click it.

1. Pick your source flags: UI / Specs / Code (any combination).
2. Click Run analysis.
3. REVETOOL AI returns 3-5 typed recommendations with title, problem, solution, severity and effort.

6. Iterate

From here, you can:

• Accept / discuss / refuse / mark done each reco
• Add manual recos (UI / Specs / Code / QA / Owner sources)
• Start a Claude inline conversation on the screen (private per user)
• Group variants into concepts (mobile + desktop + design + dev + prod)
• Move the ticket through statuses (25 statuses across 5 environments)

What is next

• Read the Connecting Figma guide for advanced Figma usage.
• Read the Connecting GitHub guide to sync PRs and previews.
• Or book a demo and we will run REVETOOL on your real product.