TubeBenderReviews

A comprehensive, professional tube bender comparison platform designed to help users choose the best equipment for their needs.

🚀 Quick Start

1. Clone & Setup

git clone https://github.com/yourusername/tubebenderreviews.git
cd tubebenderreviews
npm install

2. Environment Variables

Create a .env file:

DATABASE_URL="your-neon-postgresql-url"
JWT_SECRET="your-32-character-secret"
SESSION_SECRET="your-32-character-secret"
NODE_ENV="development"

3. Database Setup

npm run db:push

4. Run Development Server

npm run dev

🏗️ Architecture

• Frontend: React 18 + TypeScript + Tailwind CSS
• Backend: Node.js 20+ + Express.js
• Database: PostgreSQL (NEON serverless)
• Authentication: JWT with bcrypt
• Build System: Vite + ESBuild

📁 Project Structure

├── client/               # React frontend
│   ├── src/
│   │   ├── components/   # Reusable UI components
│   │   ├── pages/        # Route components
│   │   ├── hooks/        # Custom React hooks
│   │   └── lib/          # Utilities
├── server/               # Express backend
│   ├── routes.ts         # API endpoints
│   ├── storage.ts        # Database layer
│   ├── auth.ts           # Authentication
│   └── diagnostics.ts    # Debug system
├── shared/               # Shared types/schemas
└── .github/workflows/    # CI/CD automation

🔧 Features

• ✅ Comprehensive Reviews: 12 tube bender models with detailed specs
• ✅ Scoring Algorithm: Transparent 100-point rating system
• ✅ Advanced Filtering: Price, manufacturer, features, availability
• ✅ Smart Finder: Personalized recommendations based on needs
• ✅ Admin Panel: Real-time content management
• ✅ Mobile Responsive: Optimized for all devices
• ✅ Diagnostic Tools: Built-in debugging at /__debug

🎯 Admin Access

• Login: /admin-login
• Username: admin
• Password: admin123
• Panel: /admin
• Diagnostics: /__debug

🚀 Deployment Options

GitHub Pages (Recommended)

1. Push to GitHub
2. Configure secrets in repository settings
3. GitHub Actions will automatically deploy

Docker

docker build -t tubebenderreviews .
docker run -p 5000:5000 tubebenderreviews

Railway/Vercel/Netlify

• Import from GitHub
• Set environment variables
• Deploy automatically

🛠️ Development Commands

npm run dev      # Start development server
npm run build    # Build for production
npm run start    # Start production server
npm run db:push  # Push database schema
npm run check    # TypeScript type checking

📊 Performance

• Lighthouse Score: 95+ across all metrics
• Bundle Size: Optimized with code splitting
• Database: Efficient queries with Drizzle ORM
• Caching: Strategic API response caching

🔒 Security

• ✅ JWT authentication with secure tokens
• ✅ Rate limiting on all endpoints
• ✅ Input validation with Zod schemas
• ✅ CSRF protection
• ✅ Secure headers with Helmet
• ✅ Password hashing with bcrypt

📈 Monitoring

Built-in diagnostic system provides:

• Real-time performance metrics
• Database connection status
• API endpoint health checks
• Error tracking and logging
• Memory usage monitoring

Access diagnostics at /__debug endpoint.

---

Built with modern web technologies for reliability, performance, and maintainability.