🌐 Language
Open a localization issue to add a new readme to the README directory
- Deutsch: README_DE.md
- English: README.md
- Français: README_FR.md
activist.org is a platform that enables more people to safely engage in activism by making it easy to discover organizations and events as well as coordinate and collaborate on political action. We want to enable activists to learn proven and novel strategies from each other for social and ecological change. Free, open-source, privacy-focused and governed by our community.
Note
The contributing section has information for those interested.
- Our goals
- Contributing
- Environment setup
- Design and accessability
- Platform features
- Securely hosted
- Community governance
- Localization
- Supporters and partners
Our goals ⇧
The activist community is creating a global platform where movements grow and people are inspired to join in political actions. We want to update how power is distributed in our society by removing barriers and enabling more people to safely engage in activism.
The following are the working topics that activist could include:
| Environment | Housing | Refugees and Migration |
| LGTBQIA+ | Racial Justice | Women's Rights |
| Children's Rights | Elder Rights | Education |
| Health and Wellbeing | Animal Rights | Democracy |
| Labor Rights | Technology and Privacy | Peace and Resolution |
| Nutrition | Accessibility and Inclusion | Institutional Transparency |
| Freedom of Expression | Infrastructure and Mobility | Emergency Relief |
Beyond clustering by topics, tags will also be used to draw community attention to more specific issues.
Preview video ⇧
The following is a recording of the Creating and Joining Events prototype found on Figma:
activist_github_prototype.mp4
Further prototypes and designs are available in the designs for activist.
Contributing ⇧
We use Matrix for our internal communication. You're more than welcome to join us in our public chat rooms to share ideas, ask questions or just say hi to the team :)
Please see the contribution guidelines and style guide if you are interested in contributing. Work that is in progress or could be implemented is tracked in the issues and projects.
Note
Just because an issue is assigned on GitHub doesn't mean that the team isn't interested in your contribution! Feel free to write in the issues and we can potentially reassign it to you.
Also check the -next release- and -priority- labels in the issues for those that are most important, as well as those marked good first issue that are tailored for first time contributors. For those new to coding or our tech stack, we've collected links to helpful documentation pages in the contribution guidelines.
We would be happy to discuss granting you further rights as a contributor after your first pull requests, with a maintainer role then being possible after continued interest in the project. activist seeks to be an inclusive, diverse and supportive organization. We'd love to have you on the team!
How you can help ⇧
- Reporting bugs as they're found 🐞
- Working with us on new features ✨
- Localizing content for the platform 🌐
- Please join our public localization project on Weblate!
- Documentation for onboarding and project cohesion 📝
- Sharing activist.org with others! 🚀
Environment setup ⇧
- First and foremost, please see the suggested IDE setup in the dropdown below to make sure that your editor is ready for development.
Important
Suggested IDE setup
VS Code
Install the following extensions:
- batisteo.vscode-django
- bradlc.vscode-tailwindcss
- charliermarsh.ruff
- esbenp.prettier-vscode
- streetsidesoftware.code-spell-checker
- Vue.volar
WebStorm
- Check out the Vue.js development docs
- Make sure a local Node.js interpreter is configured in your project
- Make sure the Vue.js plugin and JavaScript Debugger are enabled in the plugins page of the settings
- To setup your development environment, first install Docker and Docker Compose.
Note
If you are new to Docker, activist recommends installing Docker Desktop. Docker Desktop comes with many Docker tools and a straightforward user interface.
- Fork the repo, clone your fork, and configure the remotes:
Note
Consider using SSH
Alternatively to using HTTPS as in the instructions below, consider SSH to interact with GitHub from the terminal. SSH allows you to connect without a user-pass authentication flow.
To run git commands with SSH, remember then to substitute the HTTPS URL, https://github.com/..., with the SSH one, [email protected]:....
- e.g. Cloning now becomes
git clone [email protected]:<your-username>/activist.git
GitHub also has their documentation on how to Generate a new SSH key 🔑
# Clone your fork of the repo into the current directory.
git clone https://github.com/<your-username>/activist.git
# Navigate to the newly cloned directory.
cd activist
# Assign the original repo to a remote called "upstream".
git remote add upstream https://github.com/activist-org/activist.git- Now, if you run
git remote -vyou should see two remote repositories named:origin(forked repository)upstream(activist repository)
-
Create a virtual environment for the backend, activate it and install dependencies:
# Unix or MacOS: python3 -m venv venv source venv/bin/activate # Windows: python -m venv venv venv\Scripts\activate.bat # After activating venv: pip install --upgrade pip pip install -r backend/requirements-dev.txt
-
Start your docker images with the following:
docker compose --env-file .env.dev up # Or with new dependencies: # docker compose --env-file .env.dev up --build # And to stop the containers when you're done working: # docker compose --env-file .env.dev down
-
You can then visit http://localhost:3000 to see the development frontend build once the container is up and running.
Note
Feel free to contact the team in the Development room on Matrix if you're having problems getting your environment setup! If you're having issues with Docker and just want to get the frontend or backend up and running, please see the section on this in the contributing guide.
-
Install pre-commit to ensure that each of your commits is properly checked against our linter and formatters:
# In the project root: pre-commit install
Note
pre-commit is Python package that can be installed via pip or any other Python package manager. You can also find it in our requirements.txt file.
pip install pre-commitTip
For those using LLM coding assistants, LLMPROMPT.txt contains a good prompt to paste as context or add to your settings.
Tech Stack ⇧
The following are the current and planned technologies for activist.org:
- Nuxt.js • Vue.js • TypeScript • Tailwind CSS • Headless UI
- Django • PostgreSQL (planned)
Note
Those new to any frameworks or technologies who want to work on their skills are more than welcome to contribute!
Design and accessability ⇧
The designs for activist are made using Figma. You can use the issues to make suggestions for improvements. Design related issues are marked with the design label.
We want our tools to look great, feel easy to use and function flawlessly on any device while at the same time including good security practices wherever possible. We also consistently make decisions that put a11y at the center of what we’re building.
Note
Please contact the team on GitHub or via the email on the designs welcome page if you're interested in contributing. We'd love to see a sample of your work and if everything looks good we'll schedule a time to get connected!
Platform features ⇧
The project board is where we organize our work and plan out what's next. The following sections give a general overview of the various planned features of activist.org.
Organizations profiles ⇧
Easy-to-use microsites for organizations of all sizes with multiple subpages.
Describe your organization’s aims and structure as well as answer frequently asked questions. Explain how your groups collaborate and safely onboard new people to the team.
Events ⇧
Collaborative event pages made for activists and their needs.
Organizations can create flexible event pages for different formats of events. There are two types of events:
- Learn: seminars, meetings, panel discussions
- Action: protests, volunteering, canvassing
Other event features include:
- A feed will allow organizers to share information in real time with participants
- Organizations can create event templates and share them with allies
- Event pages can be transformed into flyers or posters and linked to via QR codes
- Legal notes can be added to warn participants of the risks involved
Resources ⇧
A simple link hub for organizations.
Organizations can keep important links (chats, articles, pads, etc.) in one place, group what belongs together and pin to the top what’s currently most important. Private by default, resources can also be made public to share information and best practices.
Onboarding ⇧
Safe methods to onboard new members.
We are working on a conversational onboarding interface based on the Matrix protocol that operates across messengers while not compromising data sovereignty for organizations or individuals. Organizations will also have the option to include their existing processes if preferred.
Search ⇧
Easily find, filter and share.
Display search results in list, map and calendar views. Users can also save searches for later or set up notifications for newly published events, resources, and discussions.
Discussions ⇧
Dedicated forums for organizations and their events.
Discussions will also allow organizations, groups and events to send notifications to supporters. Included features for democratic decision making will further enable asynchronous planning.
Tasks ⇧
Kanban boards for organizing the work to be done.
Users will be able to attach kanban boards to every organization, group and event. This will allow those involved to easily plan and keep an overview of progress while templates guide organizers with best practices from our community.
Affiliates ⇧
Relationships between organizations, people and events.
Organizations and users can give support to each other as well as events:
- Supporter: a one-way relationship of support
- Ally: a relationship of mutual support
Relationships between organizations will help users find similar organizations or easily connect with actions when they’re in a new place. Affiliations will also determine notifications and access to restricted content.
Votes ⇧
Linking events and organizations to decision making.
Users will be able to subscribe for updates on events and organizations that work in relation to legislation and elections. The plan for this feature is that it will be based on data from Wikidata, with open data generating the vote pages that our community then maintains.
Securely hosted ⇧
We are hosting our data in Iceland with a reputable hosting provider that is trusted by whistleblowers, activists and investigative journalists: FlokiNET.
Iceland is a strong supporter for net neutrality with strict privacy protection laws and freedom of the press. All these factors have contributed to making Iceland a preferred destination for data centers.
You can learn more about FlokiNET on their blog.
Community governance ⇧
We not only value, but need open discourse. Our initial feature set for the MVP and future releases was developed together with our growing community of activists.
Our aim is to secure a progressive community by design while putting platform health before platform growth. Only organizations that are already on activist will be able to vouch for new organizations that apply to join. Together with experienced activists we are selecting an initial group of organizations that have a proven track record of inclusivity and elevating underrepresented groups.
We are still developing our operating principles and will always update them based on community decisions. Questions around flagging, banning, guidelines and rules will always be answered collectively.
Localization ⇧
We need to break down language barriers in order to mobilize larger and more diverse coalitions. Translation requests will be available for several assets on the platform - organization profiles, events and resources - and we are growing our network of volunteer contributors to facilitate this.
Note
Want to join our translators working group? Please join us in the localization project on Weblate and the Localization channel on Matrix to get involved!
Localization of activist is done via Weblate. Please see the localization guide for information on how to get started!
Localization coverage ⇧
Supporters and partners ⇧
Thanks to all our amazing contributors! ❤️
We would like to thank all the great software that made activist's development possible 🙏
- Countless Nuxt modules
- OpenStreetMap
- MapLibre
About Änderwerk
Änderwerk is a non-profit host organization for projects, initiatives and movements working towards a better future for people and the planet.
They take care of fiscal hosting, managing donations, budgets, accounting and the transformation of financial resources into useful tools.
They enable initiatives and groups in their hub to concentrate on what they do best – effective community-led action, aligned with their values and goals.
We are happy to be a part of this community.
About UNLOCK
These organizations have supported activist via the 2022 edition of the Wikimedia UNLOCK accelerator. UNLOCK supports open-source software projects and non-technical projects under free licenses. UNLOCK Accelerator is committed to promoting solutions that make the world's knowledge more diverse, more accessible and inclusive for everyone.
activist is not directly affiliated with any corporation, political party or government.