Skip to content

Masa-99/activist

 
 

Repository files navigation

activist Logo

platforms netlify issues django nuxt vue tailwind license coc instagram matrix

🌐 Language

Open a localization issue to add a new readme to the README directory

An open-source activism platform

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.

Contents

Our goals

The activist community is creating a global platform where movements grow and people are inspired 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.

Topics

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

Public Matrix Chat

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

Environment setup

  1. First and foremost, please see the suggested IDE extensions in the dropdown below to make sure that your editor is set up properly.
  1. To setup your development environment, first install Docker and Docker Compose.

Note

If you are new to Docker, as an alternative activist recommends installing Docker Desktop. Docker Desktop comes with many Docker tools and a straightforward user interface.

  1. 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]:....

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 -v you should see two remote repositories named:
    • origin (forked repository)
    • upstream (activist repository)
  1. Start your docker images with the following:

    docker compose up
    
    # Or with new dependencies:
    # docker compose up --build
    
    # And to stop the containers when you're done working:
    # docker compose down
  2. 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.

Tip

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:

Frontend

Backend

Deployment

Internationalization

Analytics

Note

Those new to any frameworks or technologies who want to work on their skills are more than welcome to contribute!

Design and accessability

Public Figma Designs

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 our public localization project on Transifex.

Supporters and partners

Contributors

Thanks to all our amazing contributors! ❤️

Code and dependencies

We would like to thank all the great software that made activist's development possible 🙏

Our partners

Our fiscal host Änderwerk

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.

The Wikimedia UNLOCK Accelerator

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.


Wikimedia Deutschland           Wikimedia Serbia           Impact Hub Belgrade          

Disclosure

activist is not directly affiliated with any corporation, political party or government.

About

Open-source, nonprofit activism platform

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Vue 79.8%
  • Python 15.2%
  • TypeScript 3.5%
  • CSS 1.0%
  • JavaScript 0.2%
  • HTML 0.2%
  • Dockerfile 0.1%