> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bloxora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start Guide

> Get your Bloxora workspace up and running in under 5 minutes with this comprehensive setup guide.

## Welcome to Bloxora!

This guide will help you set up your workspace and connect your Roblox group in just a few minutes.

<Steps>
  <Step title="Create Your Account">
    Visit [bloxora.com](https://bloxora.com) and sign up using your preferred method:

    <CardGroup cols={2}>
      <Card title="Roblox OAuth" icon="gamepad-2">
        **Recommended** - Automatic avatar sync and group detection
      </Card>

      <Card title="Discord Login" icon="discord">
        Quick setup with Discord integration ready
      </Card>
    </CardGroup>

    <Note>
      Using Roblox OAuth provides the best experience with automatic group discovery and avatar synchronization.
    </Note>
  </Step>

  <Step title="Link Your Roblox Account">
    If you didn't sign up with Roblox OAuth, you'll need to link your account:

    1. **Navigate to Profile Settings** in your dashboard
    2. **Click "Link Roblox Account"**
    3. **Enter your exact Roblox username** (case-sensitive)
    4. **Check your Roblox messages** for verification code
    5. **Reply with the verification code**
    6. **Return to Bloxora** and confirm verification

    <Warning>
      Make sure your Roblox privacy settings allow messages from other users, or you won't receive the verification code.
    </Warning>
  </Step>

  <Step title="Create Your Workspace">
    Set up your first workspace for your Roblox group:

    <CodeGroup>
      ```bash Required Information theme={null}
      - Workspace Name: "Your Group Name"
      - Roblox Group ID: 12345678
      - Description: Brief group description
      - Timezone: Your primary timezone
      ```
    </CodeGroup>

    **Finding Your Roblox Group ID:**

    1. Visit your group page on Roblox
    2. Check the URL: `roblox.com/groups/[GROUP_ID]/[group-name]`
    3. The number after `/groups/` is your Group ID

    <Tip>
      You can manage multiple Roblox groups by creating separate workspaces for each one.
    </Tip>
  </Step>

  <Step title="Configure Basic Settings">
    Customize your workspace with essential settings:

    ### Role Configuration

    * **Set up role hierarchy** (Owner, Admin, Moderator, etc.)
    * **Configure permissions** for each role level
    * **Enable role color coding** (Professional+ plans)

    ### Integration Setup

    * **Discord Webhook** (optional but recommended)
    * **Notification preferences**
    * **Timezone and language** settings

    <CardGroup cols={2}>
      <Card title="Discord Integration" icon="discord">
        Get automatic notifications for important events
      </Card>

      <Card title="Role Permissions" icon="users">
        Control who can access different features
      </Card>
    </CardGroup>
  </Step>

  <Step title="Invite Your Team">
    Add your staff members to the workspace:

    1. **Go to Staff Directory** → **Invite Members**
    2. **Generate invite links** for your team
    3. **Set initial roles** for new members
    4. **Send invitations** via Discord, Roblox, or email

    <Note>
      Free plan supports up to 25 members. Upgrade to Professional for up to 100 members, or Enterprise for unlimited members.
    </Note>

    ### Invite Methods

    <AccordionGroup>
      <Accordion title="Invite Links">
        Generate secure invite links with expiration dates and usage limits
      </Accordion>

      <Accordion title="Direct Invitations">
        Send invites directly through Discord or Roblox messaging
      </Accordion>

      <Accordion title="Bulk Import">
        Import existing member lists (Enterprise feature)
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>

## 🎉 You're All Set!

Your Bloxora workspace is now ready. Here's what you can do next:

<CardGroup cols={2}>
  <Card title="Meet Bloxora Assistant" icon="robot" href="/assistant/getting-started">
    Discover your AI-powered workspace companion
  </Card>

  <Card title="Explore Features" icon="sparkles" href="/features/overview">
    Learn about all the powerful tools available
  </Card>

  <Card title="Set Up Analytics" icon="chart-bar" href="/features/analytics">
    Start tracking your community's performance
  </Card>

  <Card title="Create Your First Entry" icon="book-open" href="/features/logbook">
    Begin documenting with the logbook system
  </Card>
</CardGroup>

## Common Setup Questions

<AccordionGroup>
  <Accordion title="How do I verify group ownership?">
    Bloxora automatically verifies your group ownership through Roblox OAuth. If you need manual verification:

    1. Post a specific message on your group wall
    2. Contact our support team with your workspace details
    3. We'll verify ownership within 24 hours
  </Accordion>

  <Accordion title="Can I manage multiple groups?">
    Yes! You can create separate workspaces for each Roblox group you manage. Each workspace has independent settings, members, and billing.
  </Accordion>

  <Accordion title="What if I can't receive Roblox messages?">
    Check these settings:

    * Privacy Settings → Who can message me → Everyone
    * Privacy Settings → Who can send me friend requests → Everyone (optional)
    * Make sure you're not blocking messages from new users
  </Accordion>

  <Accordion title="How do I upgrade my plan?">
    1. Go to Dashboard → Settings → Billing
    2. Click "Upgrade Plan"
    3. Choose your desired plan (Professional or Enterprise)
    4. Complete payment setup
    5. Features activate immediately
  </Accordion>
</AccordionGroup>

## Need Help?

<CardGroup cols={3}>
  <Card title="Contact Support" icon="headset" href="/support/contact">
    24/7 support for billing and critical issues
  </Card>

  <Card title="Join Discord" icon="discord" href="https://discord.gg/bloxora">
    Community support and feature discussions
  </Card>

  <Card title="Watch Tutorials" icon="play" href="https://youtube.com/bloxora">
    Step-by-step video guides
  </Card>
</CardGroup>

<Warning>
  **Security Reminder:** Never share your workspace invite links publicly. Always set appropriate expiration dates and usage limits for invite links.
</Warning>

## What's Next?

Now that your workspace is set up, explore these powerful features:

1. **[Bloxora Assistant](/assistant/overview)** - Your AI workspace companion
2. **[Analytics Dashboard](/features/analytics)** - Track community performance
3. **[Staff Directory](/features/staff-directory)** - Manage your team effectively
4. **[Logbook System](/features/logbook)** - Document important events
5. **[Session Management](/features/sessions)** - Schedule training and meetings

<Tip>
  **Pro Tip:** Enable Discord notifications to stay updated on workspace activity even when you're not actively using Bloxora.
</Tip>
