MaizeBus Web Application

A full-stack web application for MaizeBus, built with React (Vite) frontend and Node.js (Express) backend.

Project Structure

maizebus-web/
├── client/          # React frontend (Vite + TypeScript)
├── server/          # Node.js backend (Express + TypeScript)
├── package.json     # Root package.json with workspace configuration
└── README.md

Prerequisites

• Node.js (>= 18.0.0)
• npm (>= 8.0.0)

Quick Start

1. Install all dependencies:

   npm run install:all

2. Start development servers:

   npm run dev

   This will start both the frontend (port 5173) and backend (port 3001) concurrently.

3. Access the application:

   • Frontend: http://localhost:5173
   • Backend API: http://localhost:3001

Available Scripts

Root Level Scripts

• npm run dev - Start both client and server in development mode
• npm run build - Build both client and server for production
• npm run start - Start both client and server in production mode
• npm run install:all - Install dependencies for all workspaces
• npm run clean - Remove all node_modules directories
• npm run lint - Run linting for both client and server

Client Scripts (in client/ directory)

• npm run dev - Start Vite development server
• npm run build - Build for production
• npm run preview - Preview production build
• npm run lint - Run ESLint

Server Scripts (in server/ directory)

• npm run dev - Start server with nodemon
• npm run build - Compile TypeScript
• npm start - Start production server
• npm run lint - Run ESLint

Environment Variables

Server Environment Variables

Create a .env file in the server/ directory:

PORT=3001
FRONTEND_URL=http://localhost:5173
EMAIL_HOST=smtp.zoho.com
EMAIL_PORT=465
EMAIL_USER=your-email@gmail.com
EMAIL_PASS=your-app-password
EMAIL_TO=contact@maizebus.com

Development

Frontend (Client)

• Built with React 19, TypeScript, and Vite
• Uses Tailwind CSS for styling
• Includes Radix UI components
• Located in client/ directory

Backend (Server)

• Built with Express.js and TypeScript
• Handles contact forms and file uploads
• Uses Nodemailer for email functionality
• Located in server/ directory

Deployment

1. Build the application:

   npm run build

2. Start production servers:

   npm run start

License

MIT License - see LICENSE file for details