Skip to content

jorgesandev/LegisConnect

Repository files navigation

LegisConnect

Description

LegisConnect is a social network prototype enabling citizens to propose and debate legislative topics with lawmakers. The platform bridges the gap between constituents and legislators, creating a more transparent and participatory democratic process. This project won 3rd place among 375+ students at the 'Elegis Tech3' Hackathon (UABC).

Features

  • Legislative Proposals - Create, support, and track legislative proposals from submission to implementation
  • Interactive Forums - Participate in meaningful discussions on legislative topics with other citizens and lawmakers
  • Transparency Dashboard - Access detailed information about voting records, public spending, and legislative performance metrics
  • Legislator Directory - Connect with representatives and stay informed about their legislative activities
  • Interactive Map - Explore legislative districts and identify your representatives
  • Real-time Tracking - Monitor the progress of proposals through the legislative process

Technologies Used

  • Frontend: Next.js, React, TypeScript, Tailwind CSS, Radix UI
  • UI Components: shadcn/ui, Lucide React icons
  • Authentication: Next.js App Router authentication system
  • Deployment: Vercel (legisconnect.org)

Prerequisites

Before you begin, ensure you have met the following requirements:

  • You have installed Node.js (version 18.x or higher)
  • You have a modern web browser (Chrome, Firefox, Safari, Edge)

Installation

To install LegisConnect, follow these steps:

  1. Clone the repository:
    git clone https://github.com/yourusername/LegisConnect.git
    cd LegisConnect
  2. Install dependencies:
    npm install
  3. Set up environment variables:
    • Create a .env.local file in the root directory.
    • Add any necessary environment variables.
  4. Run the development server:
    npm run dev

Usage

To run the application:

npm run dev

[Add instructions on how to access the application, e.g., Open your browser and navigate to http://localhost:3000]

Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/your-feature-name).
  3. Make your changes.
  4. Commit your changes (git commit -m 'Add some feature').
  5. Push to the branch (git push origin feature/your-feature-name).
  6. Open a Pull Request.

[Optional: Add links to contribution guidelines or code of conduct if you have them.]

License

[Specify the license for your project, e.g., MIT License, Apache 2.0. If you don't have one, you can omit this section or state that it's proprietary.]

Contact

If you want to contact the maintainers, please reach out to [your name/email or project email].


This README was generated on April 22, 2025.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages