A full-stack web application for managing household tasks and services.

mini-housekeeper/
├── client/          # React frontend (Vite + TypeScript + Tailwind CSS)
├── server/          # Node.js backend (Express + PostgreSQL)
├── package.json     # Root workspace configuration
└── README.md

• React 18 - UI library
• Vite - Build tool and dev server
• TypeScript - Type safety
• Tailwind CSS - Utility-first CSS framework

• Node.js - Runtime environment
• Express - Web framework
• PostgreSQL - Database
• ES Modules - Modern JavaScript modules

• Node.js (v18 or higher)
• PostgreSQL database
• npm or pnpm

1. Install dependencies for all workspaces:

npm install

2. Set up environment variables:

cd server
cp .env.example .env
# Edit .env with your database credentials

3. Start development servers:

# Start both client and server
npm run dev

# Or start individually
npm run dev:client  # Client on http://localhost:3000
npm run dev:server  # Server on http://localhost:5000

• GET /api/health - Health check
• GET /api/db-test - Database connection test

The project uses npm workspaces for monorepo management. Each workspace (client/server) has its own package.json and can be developed independently.

cd client
npm run dev     # Start dev server
npm run build   # Build for production
npm run lint    # Run ESLint

cd server
npm run dev     # Start with nodemon
npm start       # Start production server

1. Create a PostgreSQL database named mini_housekeeper
2. Update the .env file in the server directory with your database credentials
3. The server will automatically test the connection on startup