Community

Join the Sruja community, contribute, and help shape the future of architecture-as-code.

Sruja Community

Welcome to the Sruja community! Sruja is an open source project built by and for developers who care about software architecture. Whether you’re here to learn, contribute, or get help, we’re glad you’re here.

Join the Conversation

💬 Discord

Join our Discord server for real-time chat, quick questions, and community discussions:

Join Discord

Discord is great for:

  • Getting quick help with questions
  • Discussing ideas and use cases
  • Sharing your Sruja projects
  • Connecting with other community members

💬 GitHub Discussions

For longer-form discussions, feature requests, and Q&A:

GitHub Discussions

GitHub Discussions is ideal for:

  • Feature proposals and RFCs
  • Technical discussions
  • Sharing tutorials and examples
  • Asking detailed questions

🐛 GitHub Issues

Found a bug or have a feature request?

Open an Issue

Ways to Contribute

Sruja is an open source project, and we welcome contributions of all sizes! There are many ways to contribute, even if you’re not a developer.

No Code Required

Documentation

  • Fix typos or improve clarity
  • Add examples and tutorials
  • Translate documentation
  • Write blog posts or courses

Testing & Feedback

  • Test new features and report bugs
  • Share your use cases
  • Provide feedback on design decisions
  • Help improve error messages

Community

  • Answer questions in Discord or Discussions
  • Help newcomers get started
  • Share your Sruja projects and experiences

Beginner-Friendly Code

Small Improvements

  • Add test cases
  • Fix small bugs
  • Improve error messages
  • Add examples to the examples/ directory
  • Improve CLI help text

Documentation Code

  • Add code examples
  • Update API documentation
  • Create tutorials

More Advanced Contributions

Features & Enhancements

  • Implement new features
  • Add new export formats
  • Add validation rules
  • Improve tooling and developer experience

Core Development

  • Work on the language parser
  • Enhance the validation engine
  • Build platform integrations
  • Develop plugins and extensions

Getting Started with Contributions

🎯 First Time Contributing?

Start here: Contribution Guide

This step-by-step guide walks you through:

  • Finding your first issue
  • Setting up your development environment
  • Making and submitting changes
  • Getting help when stuck

Contribution Workflow

  1. Fork and Branch: Fork the repo and create a topic branch
  2. Implement: Make your changes and test locally
  3. Commit: Follow Conventional Commits
  4. Pull Request: Open a PR with a clear description
  5. Review: Address feedback and iterate
  6. Merge: Once approved, your contribution is merged!

For detailed instructions, see the Contribution Guide.

Roadmap & Transparency

Sruja is developed transparently with community input. Our roadmap is public and open for discussion.

Current Roadmap

View Roadmap Discussions

The roadmap outlines our path to v1.0, including:

  • Advanced Governance & Compliance: Policy as code, architectural guardrails
  • Production Reality & Data Flow: Service mesh integration, runtime verification
  • Extensibility & Ecosystem: Plugin system, DevOps integrations
  • Platform Evolution: Live system review, gap detection, violation monitoring

Shaping the Roadmap

Your feedback shapes the roadmap! We welcome:

  • Feature requests via GitHub Discussions
  • Use case sharing to prioritize features
  • RFCs (Request for Comments) for major changes
  • Community voting on priorities

Community Expectations

We’re committed to maintaining a welcoming and respectful community. When participating:

  • Be respectful and constructive: Treat everyone with kindness
  • Provide actionable feedback: Help others improve their contributions
  • Prefer documented decisions: Link to ADRs or issues when relevant
  • Start small: You can always contribute more later!

Recognition

We value all contributions, big and small. Contributors are recognized through:

  • GitHub contributor list
  • Release notes (for significant contributions)
  • Community highlights in discussions

Professional Services

While Sruja is open source and free to use, professional consulting services are available for organizations that need:

  • Implementation support: Help rolling out Sruja across teams
  • Best practices guidance: Establish architectural governance patterns
  • Custom integrations: Integrate with existing CI/CD and infrastructure
  • Training: Team training on Sruja DSL and architectural modeling
  • Custom development: Build custom validators, exporters, or integrations

Contact the team through GitHub Discussions to discuss your needs.

Resources

Documentation

Development

Community

Get Involved Today

Ready to contribute? Here are some quick ways to get started:

  1. Join Discord and introduce yourself
  2. Star the repository on GitHub to show your support
  3. Fix a typo in the documentation
  4. Add an example to the examples/ directory
  5. Share your use case in GitHub Discussions

Every contribution, no matter how small, helps make Sruja better for everyone. Thank you for being part of the community!

Questions? Reach out on Discord or GitHub Discussions. We’re here to help!