Voices for Iran

Empowering Iranian-Canadians to advocate for human rights and democracy in Iran.

Voices for Iran is an open-source Blazor Server application that helps Canadian citizens easily contact their elected representatives about human rights issues in Iran. Simply enter your postal code, and the app will find your representatives and generate a personalized advocacy email.

✨ Features

• 📍 Postal Code Lookup – Automatically finds your federal, provincial, and municipal representatives based on your Canadian postal code
• ✉️ Smart Email Generation – Creates personalized advocacy emails using intelligent templates tailored to:
  • Government level (federal, provincial, municipal)
  • Political party affiliation
  • Realistic calls-to-action based on each representative's actual powers
• 🎯 Core Messaging – All emails include:
  • Solidarity with Iran's Lion-and-Sun Revolution
  • The six key demands for supporting the Iranian people
  • References to Prince Reza Pahlavi and democratic transition
  • Specific Canadian actions (IRGC removal, sanctions, refugee support)
• 📊 Impact Dashboard – Track community engagement with real-time statistics on emails generated and ridings represented
• 🔒 Privacy First – We never store your name, postal code, or any personal information
• 📱 Mobile Responsive – Full Bootstrap 5 responsive design works on any device
• 🌐 Bilingual Support – Templates available in English and French

🚀 Getting Started

Prerequisites

• .NET 10.0 SDK or later

Running Locally

1. Clone the repository

   git clone https://github.com/SHAliakbari/VoicesForIran.git
   cd VoicesForIran

2. Run the application

   dotnet run --project VoicesForIran

3. Open your browser Navigate to https://localhost:5001 or http://localhost:5000

📁 Project Structure

VoicesForIran/
├── Components/         # Blazor components and pages
├── Core/               # Core business logic and models
│   ├── Interfaces/     # Service contracts
│   ├── Models/         # Domain models
│   └── Services/       # Business logic services
├── Infrastructure/     # External concerns (API clients, database)
│   ├── Api/            # Third-party API integrations
│   └── Data/           # Database access (SQLite)
├── Templates/          # Hierarchical email templates (JSON)
│   ├── en/         # Template system configuration
│	│	├── config/         # Template system configuration
│	│	├── federal/        # Federal-level templates by party
│	│	├── provincial/     # Provincial-level templates by party
│	│	└── municipal/      # Municipal-level templates
|	└── fr/
├── wwwroot/            # Static assets (CSS, JS, images)
└── Program.cs          # Application entry point and DI setup

📨 Email Templates

The application uses a hierarchical, randomized email template system to generate context-aware messages and avoid spam detection. Templates are stored as JSON files in the Templates/ folder, organized by government level (federal, provincial, municipal) and political affiliation.

A configuration file at Templates/config/party-mapping.json maps political parties to broader ideologies, allowing for more flexible and targeted template selection.

Templates support dynamic placeholders:

Placeholder	Description
{{RepresentativeTitle}}	Full title with name (e.g., "The Hon. John Smith, M.P.")
{{RepresentativeName}}	Representative's name only
{{RidingName}}	Electoral district name
{{PostalCode}}	User's postal code
{{UserName}}	User's name (if provided)

See the Templates directory for examples. A detailed README.md for templates is planned.

🛠 Tech Stack

• Framework: .NET 10 / Blazor Server
• UI: Bootstrap 5 & Bootstrap Icons
• Database: SQLite (using Microsoft.Data.Sqlite) for impact tracking
• API Integration: HttpClient for calling the Represent API
• Architecture: Layered architecture inspired by Clean Architecture principles, using dependency injection.

🤝 Contributing

Contributions are welcome! Here's how you can help:

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

Ideas for Contributions

• 🌍 Add support for more provinces/territories
• 🇫🇷 Internationalization (French language support)
• 📧 Additional email templates
• ✅ Unit and integration tests
• 📝 Documentation improvements

🔒 Privacy

Voices for Iran is designed with privacy as a core principle:

• No personal data storage – Your name and postal code are never saved
• Minimal logging – Only aggregate statistics (riding name, MP name) are logged for the impact dashboard
• Client-side email – Emails open in your default mail client; we never see or send your emails

📜 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

• The brave people of Iran fighting for freedom in the Lion-and-Sun Revolution
• Prince Reza Pahlavi for his leadership and vision for a free, democratic Iran
• All contributors and supporters of human rights in Iran
• The Iranian-Canadian community for their continued advocacy
• Represent API for representative lookup data

📚 Resources

• Lion-and-Sun Revolution: https://iranopasmigirim.com/en
• Prince Reza Pahlavi: @PahlaviReza on Twitter/X
• Human Rights Documentation: Various international human rights organizations

---

Long live freedom. Long live Iran. Victory to Iran's Lion-and-Sun Revolution.

⭐ Star this repo • 🐛 Report Bug • 🚀 Request Feature