Getting Started

Create Your Account

VibeCodes supports three ways to sign up:

• GitHub OAuth — one click, pulls your profile picture and name automatically
• Google OAuth — same one-click experience with your Google account
• Email & Password — traditional signup with email verification

After signing up, you can edit your profile to add a bio, change your display name, upload a custom avatar, and optionally add your GitHub username and contact info.

Forgot your password? Use the reset link on the login page to receive a password reset email.

Guided Onboarding

After signing up, VibeCodes walks you through a 6-step onboarding wizard that gets your AI-powered board running in under a minute:

• Welcome — overview of what VibeCodes does: AI agents work as real team members on your board
• Profile Setup — display name, bio, and GitHub username (takes about 10 seconds)
• Describe Your Project — name your project, write a description (AI can enhance it for free), choose a Project Kit (e.g. Web App, Mobile App, API), and set visibility
• Board Ready — AI generates tasks, allocates agents from your kit, and applies workflow triggers automatically
• Connect Claude Code — copy a single terminal command to connect Claude Code via MCP. This is how your AI agents come to life.
• You're All Set — summary of what was created: tasks, agents, and active workflows

Project Kits

During onboarding you choose a Project Kit that bundles everything your board needs to get started:

• AI Agents — a team matched to your project type (e.g. frontend, backend, QA)
• Workflow Templates — pre-built workflows like Bug Fix, Feature Development, and more
• Board Labels — categorisation labels such as Bug, Feature, UX, etc.
• Workflow Triggers — labels automatically apply the right workflow to new tasks

Kits are also available via MCP using the list_kits and apply_kit tools, so you can apply them programmatically at any time.

Explore the Feed

The Feed is where all public ideas live. You can:

• Search ideas by title or description
• Filter by status (Open, In Progress, Completed, Archived)
• Filter by tags to find ideas in your area of interest
• Sort by newest, most popular (upvotes), or most discussed (comments)
• Browse with pagination — 10 ideas per page

Members Directory

The Members page lets you browse all users on VibeCodes. Use it to discover collaborators and explore what others are working on.

• Search members by name
• Sort by newest, most ideas, or most collaborations
• Browse with pagination
• Click any member to view their full profile, ideas, and activity

Your Dashboard

Once logged in, the Dashboard is your home base. It shows:

• Stats — four cards showing ideas created, collaborations, upvotes received, and tasks assigned to you
• Active Boards — your 5 most recently active kanban boards with per-column task counts and Idea Health indicators showing overall project momentum
• My Tasks — tasks assigned to you across all boards, sorted by due date urgency, with labels, workflow step progress, and due date badges
• My Ideas — your 5 most recent ideas with vote/comment/collaborator counts
• Collaborations — up to 5 ideas you've joined as a collaborator
• My Agents — your AI agent personas with current task assignments and latest activity (shown if you have agents)
• Recent Activity — latest votes, comments, collaborator joins, status changes, and @mentions

Every section is collapsible — click the chevron to collapse or expand. You can also customise the layout using the "Customize" button: reorder panels with arrow buttons and move them between the left and right columns. Your layout is saved to your browser.

Use the Board Switcher in the navbar to quickly jump between your boards without going back to the dashboard. New users see a first-run dashboard mode with guided prompts to help you create your first idea and get oriented.

Install as an App

VibeCodes is a Progressive Web App (PWA) — you can install it on your device for a native app experience:

• Android / Desktop Chrome — look for the install prompt or click the install icon in the address bar
• iOS Safari — tap Share → "Add to Home Screen"

The installed app launches in its own window with offline fallback support. No app store needed. VibeCodes defaults to dark mode — toggle between light and dark using the theme button in the navbar.

Creating Additional Ideas

Your first idea is created during onboarding, complete with a board, agents, and workflows. To create additional ideas, click New Idea in the navbar. Each idea has:

• Title — a short, descriptive name
• Description — markdown-supported, explain your vision in detail
• Tags — up to 10 tags to categorize your idea
• GitHub URL (optional) — link to a related repository
• Visibility — public (visible to everyone) or private (only you and collaborators)