5-Minute Quick Start
Get up and running with Conducky quickly! This guide helps you understand the basics in just a few minutes.
🚀 Your First 5 Minutes
Step 1: Access Conducky (30 seconds)
If you received an invitation link:
- Click the invitation link from your email
- Create an account or log in if you already have one
- Accept the invitation to join the event
If you're starting fresh:
- Visit your organization's Conducky instance (check with your admin for the URL)
- Click "Register" to create a new account
- The first account automatically becomes a System Admin
Step 2: Understand Your Dashboard (1 minute)
After logging in, you'll see your Global Dashboard:
- No events yet? You'll see instructions for joining events
- Single event user? Quick access to that event
- Multiple events? Cards showing all your events with quick stats
Key areas to notice:
- User menu (top right): Access your profile and settings
- Navigation (left sidebar): Changes based on your current context
- Event cards: Click to enter an event's workspace
Step 3: Join Your First Event (1 minute)
If you have an invite code:
- Go to your profile (
/profile/events
) - Enter the invite code in the "Join Event" section
- Confirm your participation
If you're a System Admin creating events:
- Click "Create Event" from the admin dashboard
- Fill in event details (name, slug, dates)
- Add yourself as an Event Admin
- Start inviting team members
Step 4: Explore Event Features (2 minutes)
Once in an event, explore the key features:
📊 Event Dashboard
- Overview of recent activity
- Quick access to incidents and team management
- Event-specific navigation appears in the sidebar
📝 Submit Incident (All Users)
- Click "Submit Incident" in the sidebar
- Fill out the incident details
- Upload evidence if needed
- Submit for the response team to review
📋 View Incidents
- Reporters: See "My Incidents" to track your submissions
- Responders/Admins: See "All Incidents" to manage incidents
👥 Team Management (Event Admins)
- View and manage team members
- Send invitation links to new users
- Assign roles (Reporter, Responder, Event Admin)
Step 5: Essential Navigation (30 seconds)
Three-level navigation system:
- Global Dashboard (
/dashboard
) - Multi-event overview - Event Context (
/events/[event-slug]/
) - Event-specific features - System Admin (
/admin/
) - System management (System Admins only)
Quick tip: Use the breadcrumbs at the top to understand where you are!
🎯 What's Your Role?
Incidenter (Event Attendee)
You can:
- Submit incident reports
- View and track your own incidents
- Add comments to your incidents
- Upload evidence files
Your workflow:
- Something happens → Submit an incident
- Response team investigates → You receive updates
- Add comments if you have more information
Responder (Safety Team Member)
You can:
- View all incidents in your events
- Change incident states (investigating, resolved, etc.)
- Add internal and external comments
- Assign incidents to team members
Your workflow:
- New incident arrives → Review details
- Start investigation → Change state to "investigating"
- Work the case → Add comments and updates
- Resolution → Mark as resolved or closed
Event Admin (Event Organizer)
You can:
- Everything Responders can do, plus:
- Manage team members and roles
- Configure event settings
- Create invitation links
- View event analytics and incidents
Your workflow:
- Set up event → Add team members
- Train your team → Share documentation
- Monitor incidents → Ensure proper response
- Review and improve → After-event analysis
System Admin (System Administrator)
You can:
- Create and manage events
- System-wide configuration
- User management across all events
- Access to admin interface
Important: System Admins need explicit event roles to access event data! Being a System Admin doesn't automatically grant access to event content - you must be added as an Event Admin, Responder, or Reporter for each event.
🔧 Essential Features
Incident States
Incidents flow through these states:
- Submitted → Investigating → Resolved → Closed
Comment Types
- External: Visible to everyone who can see the incident - Internal: Only visible to Responders and Event Admins
Invitation System
- Invitation links: Send to specific users for specific roles
- Invite codes: Share codes that users can redeem themselves
Multi-Event Support
- Belong to multiple events with different roles
- Switch between events using the event cards
- Cross-event incident view for responders working multiple events
🆘 Need Help?
Quick Problem Solving
Can't see navigation?
- Make sure you're logged in (name in top-right corner)
- Ensure you have roles in at least one event
Can't access an event?
- Check you have the correct role
- Verify the event URL is correct
- Contact the event administrator
Can't submit incidents?
- Ensure you have at least Reporter role
- Check all required fields are filled
- Try refreshing the page
Get More Help
- Detailed guides: User Guide for comprehensive documentation
- Technical issues: Troubleshooting Guide
- Common questions: FAQ
- Community support: GitHub Discussions
🎉 You're Ready!
That's it! You now know the basics of Conducky. Here's what to do next:
For Reporters
- Bookmark your event dashboard
- Familiarize yourself with the incident submission process
- Know how to check the status of your incidents
For Responders
- Review your team's response procedures
- Practice changing incident states and adding comments
- Set up notifications (when available)
For Event Admins
- Set up your team and send invitations
- Configure event settings and information
- Train your team on Conducky usage
For System Admins
- Complete system configuration
- Create events and add Event Admins
- Review the Admin Guide for advanced features
Ready for more? Check out the complete User Guide for detailed information about all features.