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.

• Our goals
• Contributing
• Environment setup
• Design and accessibility
• Platform features
• Securely hosted
• Community governance
• Localization
• Supporters and partners

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:

The following is a recording of the Creating and Joining Events prototype found on Figma:

Further prototypes and designs are available in the designs for activist.

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.

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!

• 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! 🚀

1. First and foremost, please see the suggested IDE setup in the dropdown below to make sure that your editor is ready for development.

2. To setup your development environment, first install Docker and Docker Compose.

3. Fork the repo, clone your fork, and configure the remotes:

# 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 -v you should see two remote repositories named:
  • origin (forked repository)
  • upstream (activist repository)

4. 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

5. Start your docker images with the following:

   # --build only necessary with new dependencies or backend model changes
   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

   Sometimes changes to the database can cause the database population to fail in your environment. If this happens, you can destroy the deployment and rebuild it:

   # Destroy your current docker-compose deployment:
   docker-compose rm -f -v --env-file .env.dev

6. You can then visit http://localhost:3000 to see the development frontend build once the container is up and running. From there click View organizations or View events to explore the platform.

7. To view the backend admin UI and Swagger UI, visit http://localhost:8000/admin and http://localhost:8000/v1/schema/swagger-ui/ respectively.

8. If you'd like to sign in to the frontend via http://localhost:3000/auth/sign-in or the Django admin panel via http://localhost:8000/admin, then you can use the fixtures admin user with the password admin.

9. 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

pip install pre-commit

The following are the current and planned technologies for activist.org:

• Nuxt.js • Vue.js • TypeScript • Tailwind CSS • Headless UI

• Django • PostgreSQL

• Docker • Netlify • Vitest (planned)

• Nuxt I18n • Weblate (activist on Weblate)

• Plausible

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.

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Localization of activist is done via Weblate. Please see the localization guide for information on how to get started!

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

The following organizations have supported activist with licenses to use their technology for free:

• Weblate
• GitBook
• Formbricks

These organizations have supported activist via the 2022 edition of the Wikimedia UNLOCK accelerator. UNLOCK supported open-source software projects and non-technical projects under free licenses. UNLOCK Accelerator was 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.