Get Involved
Community
Vexel is an open source project built by one person with help from everyone who files an issue, submits a pull request, or shares what they built. All skill levels are welcome.
GitHub
The primary home of the project. Browse the full compiler source, file bug reports, submit pull requests, watch releases, and follow development in real time.
github.com/Justme-Cliff/vexel ›Discord
A place to ask questions, share what you are building, get help with compiler errors, and discuss ideas for the language with other Vexel users.
Join the server ›Blog
Release announcements, technical deep-dives into the compiler internals, and personal writing about the experience of building a language from scratch.
Read the blog ›Twitter / X
Follow for quick updates: release notes, code snippets, development progress, and community highlights.
Follow on X ›Contributing to Vexel
Vexel is in active early development and there is a lot to build. You do not need to be an expert in compilers to contribute. The most valuable contributions often come from people using the language and running into things that could be better.
File a Bug Report
Found something that should compile but does not? A crash? An error message that is confusing? File an issue on GitHub with the program that triggered it and the full error output.
Write Example Programs
Share programs you write in Vexel. Examples are one of the best ways to document a language and help new users understand how to write idiomatic code.
Improve Error Messages
Compiler error messages are an area the language can significantly improve. If you receive an error that is unhelpful or misleading, open an issue with the context.
Standard Library
Vexel v0.1 has minimal built-ins. Writing string utilities, math functions, file I/O, and data structures in Vexel itself is a great contribution area.
Linux and macOS Support
The compiler is built on llvmlite which is cross-platform, but the build and test pipeline only runs on Windows today. Help getting it working on other platforms is very welcome.
Documentation and Tutorials
If you learn Vexel and find something unclear in the docs, improve it. Add examples, fix ambiguous wording, or write a tutorial for a specific use case.
Code of Conduct
The Vexel community should be a place where anyone can participate safely. Be respectful of other people's experience levels. Beginners are asking the same questions you asked when you were starting out.
Harassment, dismissiveness, and bad-faith criticism are not welcome. If you see behavior like this, report it through GitHub's reporting tools. The project follows the Contributor Covenant as its code of conduct.