Skip to main content
Need help with XState? The Stately community is here to support you. Whether you have questions, need debugging help, or want to share your projects, there are several ways to get assistance.

​
Community Resources

Discord Community

Real-time chat, help channel, and community discussions

GitHub Discussions

Ask questions, share ideas, and browse solutions

GitHub Issues

Report bugs and track feature requests

Stack Overflow

Search existing Q&A or ask a new question

​
Discord Server

The Stately Discord server is the best place for real-time help and community interaction.

​
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

When asking for help:
  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

For better help, share runnable examples: 
```typescript
const machine = createMachine({
  // your code here
});
```

​
GitHub Discussions

GitHub Discussions is perfect for:
  • 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

Use GitHub Issues for:
  • 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

Include:
  • 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

For 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

Stack Overflow is useful for:
  • Searchable Q&A
  • Complex technical questions
  • Integration with other libraries
Use the xstate tag when posting questions.

​
Documentation

Before seeking help, check if your question is answered in:

XState Docs

Complete XState documentation

API Reference

Detailed API documentation

Examples

Real-world example projects

Migration Guide

Upgrading from v4 to v5

​
Learning Resources

​
Tutorials and Guides

​
Video Content

​
Community Content

The community creates excellent content:
  • Blog posts and tutorials
  • Video courses
  • Podcasts and interviews
  • Open source examples
Share your content on Discord or Twitter!

​
Professional Support

For teams and enterprises:
  • Stately Studio Pro - Team features and priority support
  • Training and Workshops - Custom training for your team
  • Consulting - Architecture review and implementation help
Visit stately.ai for more information.

​
Response Times

​
Community Support

  • Discord - Usually within hours during business hours
  • GitHub Discussions - Within 1-3 days
  • GitHub Issues - Triaged within a week
Response times depend on community availability. Complex issues may take longer.

​
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

Once you learn XState:
  • 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

Stay up to date with XState:

Twitter

Follow @statelyai for updates

Newsletter

Subscribe to the Stately newsletter

Blog

Read the latest articles

YouTube

Watch tutorials and talks

​
Contributing Back

The best way to improve support is to contribute:
  • Answer questions on Discord or GitHub
  • Improve documentation
  • Create examples and tutorials
  • Report and fix bugs
  • Share your use cases
See the Contributing Guide to get started.
Welcome to the XState community! We’re excited to have you here and happy to help you build amazing stateful applications. 🎉