Quickstart Guide

Go from zero to your first tracked outcome in under five minutes. This guide walks you through signing up, creating your organization, building your first team, and launching an outcome with work cards — everything you need to start orchestrating work with Joyous.

Sign up for Joyous

You can create your account with either Google OAuth or an email and password.

1. Go to the sign-up page

   Navigate to the Joyous sign-up page. You'll see two options: Continue with Google for one-click sign-up, or the email form below it.

2. Create your account

   If using email, enter your Full name, Work email, and a Password (minimum 6 characters), then click Create account. If using Google, click Continue with Google and authorize access.

Create your organization

After signing up, you'll land on the onboarding screen where you choose between creating a new organization or joining an existing one with an invite code.

1. Choose 'Create a new organization'

   Click Create a new organization to set up a fresh workspace for your team.

2. Enter your org details

   Fill in your Organization Name (e.g., "Acme Corp") and Company Website (e.g., "acme.com"). Joyous automatically normalizes the domain — no need to include "https://" or "www."

3. Click Create Organization

   You'll be assigned the Owner role automatically, giving you full control over settings, members, and billing.

Set up your profile

Once your organization is created, Joyous walks you through a quick profile setup so your team knows who you are.

1. Choose your avatar color

   Pick a color from the avatar color picker. Your initials will appear on this colored circle throughout the app.

2. Add your job title

   Enter your role — something like "Engineering Lead" or "Product Designer" — so teammates can see your function at a glance.

3. Write a short bio (optional)

   Add a brief description of what you do. This shows up on your profile and helps new team members get oriented.

Create your first outcome

With your org ready, it's time to define what you want to achieve. Outcomes are the goals that drive all work in Joyous.

1. Navigate to Outcomes

   Click Outcomes in the sidebar to open the outcomes list.

2. Click New Outcome

   Hit the New Outcome button to open the creation form.

3. Set your goal

   Write a clear, measurable goal — for example, "Launch v2.0 marketing site by end of Q3." Add context and success signals to define what done looks like.

Add work cards

Break your outcome into concrete tasks by creating work cards.

1. Open your outcome

   Click into the outcome you just created to see its detail page.

2. Add cards manually or with AI

   Click Add Card to create cards one by one, or use the AI Decompose action to let the AI agent suggest a full set of cards with effort estimates based on your goal.

3. Review and refine

   Each card starts in Backlog status. Move cards to Open when you're ready to work on them, or commit them to a sprint for time-boxed execution.

Next Steps

• Core Concepts — Understand how Outcomes, Work Cards, Teams, and Sprints fit together
• Creating Your Organization — Deep dive into organization setup and configuration