⛅ Coming soon: create Unison Cloud clusters in minutes on your own infrastructure. Learn more

😃 Community

Hello and thanks for joining us!

We're committed to creating inclusive, friendly spaces where people of all backgrounds and experience levels feel welcome. Respect and kindness are the foundation of this community. For more details, please see our code of conduct.

Join the conversation, ask questions, and connect with other Unison enthusiasts in these spaces:

Some common community questions and topics

How do I share my code?

If you want to publicly share your code (or look at code that others have shared), check out Unison Share.

You use the Unison Codebase Manager's push command, to write it to your own remotely hosted repository.

(There's also always the option of zipping up your .unison directory! Its contents are free-standing and portable.)

Are you looking for help with developing Unison?

Yes! Please come and get involved 😊

The first step is to play with the language, and get familiar with writing Unison code. Also, come join the Discord, and browse through the issue tracker to see what's going on.

Contributing Unison code

Is there a library you could write in Unison? That's a way to contribute which requires very little coordination with the compiler team, and can have a big impact on the usability of the overall Unison ecosystem. There's a catalog of libraries here - do add yours! Let us know in the Discord (channel #libraries) what you're working on 😎

You could also try fixing some omissions from the base library - check out the tickets tab in the Base project for the contributions that would be most welcome.

Contributing to the Unison language/compiler/toolchain

You can dip your toes by finding small ways to contribute a little piece: - take a look at the issues labelled good first issue and help wanted - see if you can find any tidying or refactoring you think needs doing in the parser-typechecker source (chat to us on Discord before spending much time) - are there any contributor docs you'd like to see which you could make a start on?

Once you've had your first PR merged and gotten to know how we work, have a think whether you want to take on a bigger project! There's lots of cool stuff to do. Get in touch with Paul Chiusano via the Discord and give him an idea of your areas of interest and level of experience. If you have your own suggestions for what you could work on then let him know!

Hosting a Local Meetup

The Unison community—like the language itself—is distributed! If you're interested in organizing a local Unison meetup, we'd love to support you by sharing and promoting your events to help others discover it.

🍕
We're also happy to sponsor your meetup with pizza and soft drinks as a small token of appreciation for bringing people together from Remote.far to Remote.near!

To receive sponsorship, we ask that your event follows the Unison Code of Conduct. We strive to foster a friendly, welcoming community, and we appreciate your help in making that happen.

Organizing process

Join the Unison Discord - Hop into our Discord and mention in #general that you're interested in starting a Unison meetup.

Find a location - You'll need to find a place to meet. Past organizers have hosted small groups at their office spaces after work.

Choose an event platform - Choose a platform for scheduling your event, such as Meetup, Eventbrite, or even a simple Google Form for RSVPs. If you're receiving sponsorship, include a link to our Code of Conduct for attendees to follow.

Give us a headcount - Let us know roughly how many attendees you expect so we can plan a pizza budget accordingly.

Share your event - Once your event is live, send us a link to a tweet or post so we can help spread the word!

Save your receipts - If you're receiving sponsorship for dinner, hold onto your receipts so we can reimburse you.