It all started with our shared frustration over opaque ranking sites and clunky group chat polls. We were fed up with hidden algorithms that left users guessing how votes were counted, breeding distrust and skepticism. That’s when TrueConsensus was born—a platform designed to shatter the mystery and revolutionize voting. By eliminating the need to create polls in group chats, we deliver a seamless, transparent experience where every vote counts right on the website.
Our mission is clear: restore trust and clarity to the voting process. We built TrueConsensus as an open-source platform featuring an algorithm that anyone can inspect, verify, and even modify. This isn’t just about voting but about empowering you with complete visibility and control over the process.
- Frontend: Next.js, Tailwind CSS
- Backend: NestJS, TypeORM
- Database: PostgreSQL
- Authentication: Firebase
- Hosting: Vercel (frontend) & Render (backend)
- Languages: TypeScript and JavaScript
Main Page:
Rankings:
Voting Page
One of our toughest challenges was ensuring that every authenticated user could vote only once, maintaining the integrity of our system. Crafting a transparent algorithm using the Condorcet voting method demanded innovative thinking and rigorous planning. The Condorcet method is a voting system that identifies the candidate who would win a one-on-one election against each of the other candidates. This method ensures that the most broadly preferred candidate wins, rather than just the one with the most votes. Despite these hurdles, we’re proud to have built a platform that invites community collaboration and empowers users to redefine how voting should work.
we learned how to stack cups like a pro.
- Scaling the platform to serve a larger community
- Expanding the reach of our transparent, community-driven voting system
- Disrupting outdated voting methods with fresh, user-first innovations
We welcome contributions from the community to help improve TrueConsensus. Whether you want to work on the backend algorithms or the frontend application, follow the steps below to get started.
- Clone the Repository:
git clone https://github.com/ShashiSugrim/TrueConsensus.git cd TrueConsensus/backend - Setup the Environment:
npm install
- Modify the Algorithm:
- Navigate to the src directory where the backend algorithm is located.
- Follow the conventions provided in the existing code to replace or modify the algorithm.
- Ensure that your changes maintain the integrity and functionality of the system.
- Commit and Push:
git commit -m "Describe your changes here" git push origin your-branch-name