Getting Started

GitScrum Studio is a project management platform built for development teams. This guide covers account creation, authentication, and initial workspace setup.

Authentication

GitScrum supports two authentication methods: OAuth providers and email/password.

OAuth Sign In

The fastest way to access GitScrum:

1. Navigate to app.gitscrum.com
2. Click Continue with Google or Continue with GitHub
3. Authorize GitScrum in the OAuth provider popup
4. You're redirected to your dashboard

OAuth creates your account automatically on first sign in. No email verification required.

Email Sign In

For users who prefer traditional authentication:

1. Navigate to app.gitscrum.com
2. Enter your email address
3. Enter your password
4. Click Sign in

Forgot your password? Click Forgot password to receive a reset link via email.

Creating an Account

New users can create an account through OAuth or email registration.

OAuth Registration

1. Click Continue with Google or Continue with GitHub
2. Authorize the connection
3. Complete the onboarding flow (name, workspace creation)
4. Start using GitScrum

Email Registration

1. Click Create account
2. Enter your full name
3. Enter your email address
4. Create a password (minimum 8 characters)
5. Click Create account
6. Verify your email via the confirmation link
7. Complete onboarding

Onboarding

After account creation, the onboarding wizard guides you through initial setup.

Step 1: Profile Setup

Configure your identity in GitScrum:

Step 2: Workspace Creation

Create your first workspace or join an existing one:

Creating a new workspace:

• Enter workspace name (your company or team name)
• Choose a URL slug (e.g., acme-corp)
• Select your primary use case

Joining via invitation: If you were invited, the workspace is pre-configured. Skip to project access.

Accepting Team Invitations

When someone invites you to their workspace:

1. Check your email for the invitation link
2. Click the invitation link
3. Sign in or create an account
4. Accept the invitation
5. Access the shared workspace

Invitation links expire after 7 days. Request a new invitation if expired.

Invitation Roles

Your role determines your permissions:

First Steps After Setup

Once authenticated and onboarded:

1. Create Your First Project

Navigate to the workspace dashboard and click New Project. Configure:

• Project name and description
• Privacy settings (public or private)
• Team member assignments

2. Set Up Your Board

GitScrum creates a default Kanban board with columns:

• Backlog → To Do → In Progress → Done

Customize columns to match your workflow in Project Settings.

3. Invite Team Members

From the workspace sidebar, go to Team Members and click Add Member:

• Enter email addresses
• Select role for each invitee
• Send invitations

Team members receive email invitations with direct access links.

Keyboard Shortcuts

GitScrum supports keyboard navigation:

Mastering keyboard shortcuts significantly improves your productivity when working with GitScrum daily. The quick search command (Cmd/Ctrl + K) is particularly powerful, allowing you to find tasks, projects, and team members without using the mouse.

Understanding the GitScrum Interface

Workspace Dashboard

After login, you land on the Workspace Dashboard. This central hub shows:

• Active Projects: Quick access tiles for projects you work on
• Recent Activity: Latest updates from team members
• Your Tasks: Upcoming deadlines and assigned items
• Team Overview: Who's online and their current focus

Navigation Structure

GitScrum uses a consistent navigation pattern:

1. Top Header: Workspace selector, search, notifications, profile
2. Left Sidebar: Primary navigation for workspace features
3. Main Content: Dynamic area showing selected feature
4. Right Panel: Contextual information and quick actions (when applicable)

Project Context

When inside a project, the navigation adapts to show project-specific options:

• Kanban Board: Visual task management
• User Stories: Backlog and feature planning
• Sprints: Iteration planning (if enabled)
• Wiki: Project documentation
• Settings: Project configuration

Common First-Week Tasks

Day 1: Orientation

• Complete profile setup with photo and timezone
• Browse existing projects to understand current work
• Review team member list to identify key collaborators
• Set notification preferences to avoid overwhelm

Day 2-3: Workflow Integration

• Create your first task and assign it to yourself
• Log time against a task to understand time tracking
• Comment on a teammate's task to practice collaboration
• Explore the Kanban board drag-and-drop functionality

Day 4-5: Advanced Features

• Set up your first sprint (if using Scrum methodology)
• Create a wiki page with notes or documentation
• Start a discussion thread for team feedback
• Generate your first report to see analytics

Troubleshooting First-Time Issues

Cannot Access Workspace

If you cannot see your workspace after login:

1. Verify you accepted the invitation email
2. Check you're using the correct login method (OAuth vs email)
3. Contact the workspace owner to resend invitation
4. Ensure the invitation hasn't expired (7-day limit)

OAuth Connection Failed

If Google or GitHub login fails:

1. Clear browser cookies for GitScrum
2. Try a different browser
3. Disable browser extensions temporarily
4. Check if your organization blocks OAuth apps

Email Verification Not Received

If the verification email doesn't arrive:

1. Check spam/junk folders
2. Add noreply@gitscrum.com to contacts
3. Request a new verification email from login page
4. Verify the email address has no typos

Mobile Access

GitScrum is fully responsive and works on mobile browsers. While there's no dedicated mobile app, you can:

• Add GitScrum to your home screen for quick access
• Receive push notifications through your browser
• Update task statuses while on the go
• Review team activity and comments
• Log time from mobile devices

For the best mobile experience, we recommend Chrome on Android or Safari on iOS.

System Requirements

GitScrum runs in modern browsers:

• Chrome 90+
• Firefox 88+
• Safari 14+
• Edge 90+

JavaScript must be enabled. We recommend a screen resolution of 1280×720 or higher for optimal experience. GitScrum uses responsive design, so it adapts to smaller screens, but some advanced features work best on larger displays.

Network Requirements

GitScrum requires a stable internet connection. The platform uses real-time updates, so:

• Minimum 1 Mbps connection recommended
• Websockets must not be blocked by firewalls
• Corporate proxy settings may require configuration

Getting Help

If you encounter issues during setup or have questions:

1. This Documentation: Browse guides for detailed feature explanations
2. In-App Help: Look for help icons (?) throughout the interface
3. Support Tickets: Submit requests through the Support section
4. Community: Connect with other users for tips and best practices

GitScrum Pro subscribers receive priority support with faster response times.

Related Documentation

• Workspace Dashboard - Navigate your workspace
• Kanban Board - Manage tasks visually
• Team Members - Invite and manage collaborators
• Profile Settings - Configure your account
• Workspace Settings - Configure workspace options