Blockchain Poll

A blockchain-based polling application built with React, TypeScript, and Ethereum smart contracts.

Project Structure

This is a monorepo using Yarn workspaces with the following packages:

• packages/client - React frontend application
• packages/server - Express.js backend with blockchain integration

Prerequisites

• Node.js (v18 or higher)
• Yarn (v1.22.19 or higher)
• Git

Getting Started

1. Install Dependencies

yarn install

This will install all dependencies for both the client and server packages.

2. Development

To start both the client and server in development mode:

# Start the client (React app) on http://localhost:3333
yarn dev:client

# Start the server (Express API) on http://localhost:3000
yarn dev:server

3. Building

To build both packages for production:

# Build the client
yarn build:client

# Build the server
yarn build:server

4. Production

To start the production servers:

# Start the client preview server
yarn start:client

# Start the production server
yarn start:server

Workspace Commands

You can also run commands directly in specific packages:

# Run a command in the client package
yarn workspace @blockchain-poll/client <command>

# Run a command in the server package
yarn workspace @blockchain-poll/server <command>

Development Tools

• Linting: yarn lint
• Formatting: yarn format

Features

• Modern React application with TypeScript
• Blockchain integration with Ethereum
• PWA support
• Responsive design with Tailwind CSS
• Internationalization (i18n)

Tech Stack

Frontend

• React 19
• TypeScript
• Vite
• Tailwind CSS
• Radix UI components
• React Router
• Zustand for state management

Backend

• Express.js
• TypeScript
• Ethers.js for blockchain interaction
• Hardhat for smart contract development

License

MIT