A modern, secure, and transparent voting application built on blockchain technology and deployed on Google Cloud Platform. VoteChain revolutionizes the voting process by ensuring immutability, transparency, and security through distributed ledger technology.
- 🔒 Blockchain Security: All votes are encrypted and stored on an immutable blockchain
- ☁️ Google Cloud Infrastructure: Lightning-fast performance with global scalability
- 🎨 Modern UI/UX: Beautiful, responsive design built with React and Tailwind CSS
- 📊 Real-time Results: Live vote counting and results visualization
- 🔐 Secure Authentication: Multiple layers of security for voter verification
- 📱 Mobile Responsive: Optimized for all devices and screen sizes
- 🌐 Transparent Process: Complete audit trail for all voting activities
- React 18.3.1 - Modern UI framework
- Tailwind CSS 3.4.10 - Utility-first styling
- Framer Motion 11.5.6 - Smooth animations and transitions
- React Router DOM 6.26.1 - Client-side routing
- Lucide React - Beautiful icon library
- Recharts 2.12.7 - Data visualization
- Axios 1.7.7 - HTTP client for API calls
- Google Cloud Platform - Cloud hosting and services
- Blockchain Technology - Immutable vote storage
- Progressive Web App (PWA) - App-like experience
- Node.js (v16 or higher)
- npm or yarn package manager
- Git
-
Clone the repository
git clone https://github.com/your-username/VoteChain.git cd VoteChain -
Install dependencies
npm install
-
Start the development server
npm start
-
Open your browser Navigate to
http://localhost:3000to see the application running.
npm run buildThis creates an optimized production build in the build/ folder.
VoteChain/
├── public/
│ ├── index.html
│ └── site.webmanifest
├── src/
│ ├── AdminPanel.js # Poll creation and management
│ ├── App.js # Main application component
│ ├── Home.jsx # Landing page
│ ├── VotingInterface.js # Voting functionality
│ ├── ThemeContext.js # Theme management
│ ├── localStorage.js # Local storage utilities
│ └── index.js # Application entry point
├── package.json
├── tailwind.config.js
├── vercel.json
├── .gitignore
└── README.md
- Modern landing page with gradient backgrounds
- Animated cards showcasing platform features
- Navigation to voting and admin interfaces
- Responsive design with hover effects
- Secure ballot casting
- Real-time vote validation
- Blockchain transaction confirmation
- User-friendly voting experience
- Poll creation and management
- Candidate registration
- Voting period configuration
- Results monitoring and analytics
- Blockchain Immutability: Once cast, votes cannot be altered or deleted
- Cryptographic Hashing: All votes are cryptographically secured
- Decentralized Storage: No single point of failure
- Audit Trail: Complete transparency with verifiable voting records
- Identity Verification: Secure voter authentication system
VoteChain leverages Google Cloud Platform for:
- Compute Engine: Scalable virtual machines for application hosting
- Cloud Storage: Secure storage for application assets
- Cloud CDN: Fast content delivery worldwide
- Cloud Security: Advanced security and DDoS protection
- Cloud Monitoring: Real-time performance monitoring
- Auto Scaling: Automatic scaling based on demand
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ User Vote │───▶│ Blockchain │───▶│ Verification │
│ │ │ Network │ │ & Storage │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Cryptographic │ │ Distributed │ │ Immutable │
│ Encryption │ │ Ledger │ │ Record │
└─────────────────┘ └─────────────────┘ └─────────────────┘
VoteChain is currently under active development. This is a work-in-progress project with the following roadmap:
- Frontend UI/UX design
- Basic routing and navigation
- Responsive layout with Tailwind CSS
- Animation system with Framer Motion
- Project structure and build setup
- Blockchain integration
- Google Cloud deployment pipeline
- User authentication system
- Voting mechanism implementation
- Admin dashboard functionality
- Multi-language support
- Advanced analytics dashboard
- Mobile app development
- Integration with external identity providers
- Advanced reporting and audit tools
- API for third-party integrations
We welcome contributions to VoteChain! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow React best practices
- Use TypeScript for new components (migration in progress)
- Maintain responsive design principles
- Write comprehensive tests
- Document all new features
This project is licensed under the MIT License - see the LICENSE file for details.
- Google Cloud Platform for infrastructure support
- React community for the amazing ecosystem
- Blockchain technology pioneers
- Open source contributors and maintainers
🔗 Connect with us: Follow our development progress and get updates on new features and releases.
Secure • Transparent • Decentralized
This project should be cloned as VoteChain (with capital letters) to maintain consistency:
git clone https://github.com/your-username/VoteChain.git
cd VoteChain-
Connect your repository to Vercel
- Repository name:
VoteChain - Framework Preset:
Create React App
- Repository name:
-
Build Configuration:
{ "buildCommand": "npm run build", "outputDirectory": "build", "installCommand": "npm install" } -
Environment Variables (Optional):
NODE_ENV=production GENERATE_SOURCEMAP=false
If you're getting build errors:
- Ensure your repository is named
VoteChain(capital V and C) - Verify that
public/index.htmlexists in your project root - Check that your
package.jsonhas the correct build scripts - Make sure
vercel.jsonis in the project root
To avoid duplicate repositories:
- Use consistent naming:
VoteChain(notvotechain) - If you have both, delete the incorrect one and keep
VoteChain - Update your local remote URL if needed:
git remote set-url origin https://github.com/your-username/VoteChain.git