Skip to main content

​
Welcome to BoxApp

BoxApp is a comprehensive CrossFit gym management platform built for box owners, coaches, and athletes. Get your box up and running in just a few minutes.
New to BoxApp? This guide will walk you through setting up your box, configuring your admin account, and getting your first members onboarded.

​
Create Your Box

1

Register Your Box

Navigate to the registration page and provide your box information:
// BoxApp uses a multi-step registration process
// Step 1: Box Information
- Box Name: Your gym's name (e.g., "CrossFit Arena")
- URL Slug: Your unique subdomain (e.g., "crossfit-arena")
- Country: Select from available countries
Your box will be accessible at your-slug.boxora.website or via URL parameter in local development.
The slug must be 3-50 characters, containing only lowercase letters, numbers, and hyphens. BoxApp automatically checks availability in real-time.
2

Create Admin Account

Set up your administrator credentials:
  • Email: Your admin email address
  • Password: Minimum 8 characters
// Your admin account is created with full permissions
options: {
  data: {
    box_id: newBoxId,
    role_id: 'admin',
    full_name: `${boxName} Admin`
  }
}
Keep your admin credentials secure. You’ll use this account to manage all aspects of your box.
3

Complete Registration

After submitting, BoxApp will:
  1. Create your box in the database
  2. Set up your admin account
  3. Initialize your subscription (trial status)
  4. Redirect you to your box dashboard
New boxes automatically start with a trial subscription. You can upgrade from the billing settings later.

​
Access Your Dashboard

Once registered, you’ll be redirected to your personalized dashboard based on your role: 
// Admins see comprehensive analytics
- Member count and growth metrics
- Daily WOD programming
- Attendance rates (last 30 days)
- Pending leads
- Recent benchmark results

​
Add Your First Members

Now that your box is set up, invite your members:
1

Navigate to Members

From your dashboard, go to the Members section in the navigation menu.
2

Add New Member

Click “Add Member” and provide:
  • First and last name
  • Email address
  • Role (athlete, coach, or admin)
  • Initial password (they can change it later)
Members can also self-register through your box’s login page if you enable public signups.
3

Send Invitations

Members will receive login credentials and can:
  • Access their personalized dashboard
  • Book classes
  • Log workout results
  • Track personal records

​
Configure Your Box Settings

Customize your box to match your brand:
  • Logo: Upload your box logo
  • Login Background: Custom background image for login page
  • Box Name: Update your display name
  • Time Zone: Set your local timezone for scheduling
  • WOD Tracks: Create multiple tracks (RX, Scaled, Beginner)
  • Schedule Classes: Set up recurring class times
  • Movement Library: Add custom movements and exercises
  • Benchmarks: Configure standard CrossFit benchmarks
  • Roles: Define custom roles and permissions
  • Billing: Set up membership plans and pricing
  • Attendance: Configure check-in requirements
  • Lead Tracking: Manage prospective members

​
Next Steps

You’re all set! Here’s what to do next:
  1. Create Your First WOD - Add today’s programming
  2. Set Up Class Schedule - Define your weekly class times
  3. Import Members - Bulk upload existing members
  4. Configure Billing - Set up membership plans
  5. Customize Branding - Add your logo and colors
Check out the full Installation Guide for advanced configuration options and environment setup.

​
Need Help?

If you encounter any issues:
  • Review the detailed Installation Guide
  • Check the authentication flow in src/pages/Login.tsx:70
  • Verify your Supabase credentials in .env
  • Ensure your database migrations are up to date
Make sure your Supabase project is properly configured with the required tables: boxes, profiles, wods, bookings, leads, and results.

Build docs developers (and LLMs) love

Get started for freeTalk to us