Getting Support

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/statelyai/xstate/llms.txt

Use this file to discover all available pages before exploring further.

​

Community Resources

​

Discord Server

​

What You’ll Find

• #help - Get assistance with XState questions
• #general - General discussion about state machines and XState
• #showcase - Share projects you’ve built with XState
• #stately-studio - Questions about Stately Studio
• #announcements - Latest news and updates
• #contributing - Discuss contributions to XState

​

Getting Help on Discord

1. Check existing messages - Your question may have been answered
2. Be specific - Describe what you’re trying to accomplish
3. Share code - Provide a minimal reproduction if possible
4. Include context - Mention your XState version and environment
5. Be patient - Community members volunteer their time

​

Code Sharing Tips

• Use Stately Studio for machine configurations
• Create a CodeSandbox or StackBlitz reproduction
• Use Discord code blocks with syntax highlighting:

```typescript
const machine = createMachine({
  // your code here
});
```

​

GitHub Discussions

• Questions - Ask detailed questions that benefit from threaded discussions
• Ideas - Propose and discuss new features or improvements
• Show and Tell - Share projects, patterns, and use cases
• General Discussion - Broader conversations about state machines

​

Discussion Categories

• Q&A - Get answers to your questions
• Ideas - Propose new features
• Show and tell - Share what you’ve built
• General - Open-ended discussions

​

Tips for Great Discussions

• Search before posting to avoid duplicates
• Use descriptive titles
• Mark helpful answers as solutions
• Engage with others’ questions
• Share back when you find solutions

​

GitHub Issues

• Bug Reports - Report reproducible bugs
• Feature Requests - Suggest new features
• Documentation Issues - Report doc problems

​

Before Creating an Issue

1. Search existing issues first
2. Check the documentation
3. Try the latest version of XState
4. Create a minimal reproduction

​

Creating a Good Bug Report

• Clear title - Summarize the issue
• Description - What’s happening vs what should happen
• Reproduction - Minimal code to reproduce the issue
• Environment - XState version, Node version, browser, etc.
• Steps - Step-by-step instructions to reproduce
• Expected behavior - What you expected to happen
• Actual behavior - What actually happened

​

Feature Requests

• Explain the use case and problem you’re solving
• Describe your proposed solution
• Consider alternatives you’ve explored
• Provide code examples if applicable
• Link to related discussions or issues

​

Stack Overflow

• Searchable Q&A
• Complex technical questions
• Integration with other libraries

​

Documentation

​

Learning Resources

​

Tutorials and Guides

• Getting Started Guide
• XState Catalogue - Common state machine patterns
• Stately Blog - In-depth articles and tutorials

​

Video Content

• Stately YouTube Channel
• Conference talks and presentations
• Live streams and workshops

​

Community Content

• Blog posts and tutorials
• Video courses
• Podcasts and interviews
• Open source examples

​

Professional Support

• Stately Studio Pro - Team features and priority support
• Training and Workshops - Custom training for your team
• Consulting - Architecture review and implementation help

​

Response Times

​

Community Support

• Discord - Usually within hours during business hours
• GitHub Discussions - Within 1-3 days
• GitHub Issues - Triaged within a week

​

What to Expect

• The community includes XState maintainers and experienced users
• Most common questions are answered quickly
• Bug reports are prioritized based on severity and impact
• Feature requests are discussed and considered for roadmap

​

Community Guidelines

​

Be Respectful

• Treat others with kindness and respect
• Appreciate that community members volunteer their time
• Follow the Code of Conduct

​

Help Others

• Answer questions from newcomers
• Share your experiences and solutions
• Contribute to documentation
• Report bugs and suggest improvements

​

Share Knowledge

• Write blog posts about your XState experiences
• Create example projects
• Give talks at meetups or conferences
• Contribute to open source XState projects

​

Stay Connected

​

Contributing Back

• Answer questions on Discord or GitHub
• Improve documentation
• Create examples and tutorials
• Report and fix bugs
• Share your use cases