A full-stack modern web application built for the Swedish metal band Morbid Gene, featuring an integrated e-commerce solution with Spreadshirt API integration, user authentication, and a comprehensive content management system.
This application serves as both the official band website and merchandise store for Morbid Gene. Built with React 19 and Node.js, it provides a seamless user experience across multiple device types with a focus on mobile-first design and accessibility.
Live Demo: [www.morbidgeneofficial.com]
- Merchandise Store with real-time Spreadshirt API integration
- Shopping Cart with persistent state management
- Product Catalog with filtering and search capabilities
- Secure Checkout with external payment processing
- User Favorites with authenticated wishlist functionality
- JWT Authentication with secure httpOnly cookies
- User Registration & Login with password encryption
- Account Settings with profile management
- Session Management with automatic cleanup
- Media Gallery with responsive image displays
- Gigs Schedule with venue and ticket information
- Contact Forms for general inquiries and booking requests
- Fully Responsive design (320px - 1600px+)
- Accessibility Compliant with WCAG standards
- Progressive Enhancement with loading states
- Real-time Updates via Context API state management
- React 19 - Latest React with modern hooks
- Vite - Fast build tool and development server
- React Router DOM 7 - Client-side routing with nested routes
- Styled Components - CSS-in-JS styling solution
- Context API - Global state management
- React Icons - Comprehensive icon library
- Node.js with Express 4 - RESTful API server
- MongoDB with Mongoose - Document database
- JWT - Secure token-based authentication
- bcryptjs - Password hashing and validation
- Nodemailer - Email service integration
- Axios - HTTP client for external APIs
- Spreadshirt API - Merchandise and fulfillment
- Email Service - Contact form and notifications
- Cookie Management - Secure session handling
- Node.js 18+
- MongoDB (local or Atlas)
- Git
Create .env files in both frontend and backend directories:
Backend .env:
# Database
MONGO_URL=mongodb://localhost:
# Authentication
JWT_SECRET=your-super-secure-jwt-secret-here
# Spreadshirt API
SPREADSHOP_ID=your-spreadshop-id
SPREADSHOP_API_KEY=your-api-key
SPREAD_USER_AGENT=YourApp/1.0
# Email Service (optional)
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_USER=your-email@example.com
EMAIL_PASSWORD=your-email-password
# Server
PORT=8080Frontend .env (if needed):
VITE_API_URL=http://localhost:- Clone the repository
git clone https://github.com/yourusername/morbid-gene-2.0.git
cd morbid-gene-2.0- Install backend dependencies
cd backend
npm install- Install frontend dependencies
cd ../frontend
npm install- Start development servers
In separate terminals:
# Backend (from backend directory)
npm run dev
# Frontend (from frontend directory)
npm run devThe application will be available at:
- Frontend:
http://localhost:5173 - Backend API:
http://localhost:8080
# Build frontend
cd frontend
npm run build
# Start production backend
cd ../backend
npm startmorbid-gene-2.0/
โโโ backend/ # Node.js API server
โ โโโ controllers/ # Business logic
โ โโโ middleware/ # Auth & request processing
โ โโโ models/ # MongoDB schemas
โ โโโ routes/ # API endpoints
โ โโโ services/ # External API integrations
โ โโโ utils/ # Helper functions
โ โโโ server.js # Express server setup
โ
โโโ frontend/ # React application
โ โโโ src/
โ โ โโโ components/ # Reusable UI components
โ โ โโโ contexts/ # React Context providers
โ โ โโโ hooks/ # Custom React hooks
โ โ โโโ pages/ # Route components
โ โ โโโ styles/ # Global styles & themes
โ โ โโโ utils/ # Helper functions
โ โ โโโ App.jsx # Main application component
โ โ
โ โโโ public/ # Static assets
โ โโโ package.json # Frontend dependencies
โ
โโโ README.md # This file
- Browse Merchandise: Visit the shop to see available products
- Create Account: Register to save favorites
- Add to Cart: Select size, color, and quantity for products
- Secure Checkout: Complete purchase through Spreadshirt
- Manage Account: Update profilesettings
- API Integration: Use the RESTful endpoints (see API.md)
- Theme Customization: Modify
styles/theme.jsfor visual changes - Component Development: Follow the established patterns in
/components - State Management: Use Context providers for global state
The backend can be deployed to any Node.js hosting service:
- Railway
- Heroku
- DigitalOcean App Platform
- AWS EC2
The frontend builds to static files compatible with:
- Netlify
- Vercel
- GitHub Pages
- Any static hosting service
MongoDB can be hosted on:
- MongoDB Atlas (recommended)
- Local MongoDB instance
- DigitalOcean Managed Databases
Frontend:
npm run dev # Start development server
npm run build # Build for production
npm run preview # Preview production build
npm run lint # Run ESLintBackend:
npm run dev # Start with nodemon (development)
npm start # Start production server- Code Style: Follow existing patterns and use ESLint
- Components: Keep components focused and reusable
- State Management: Use Context API for global state
- Styling: Use styled-components with the theme system
- API Calls: Use the established API utilities
The application includes several custom React hooks:
useProduct(productId)- Fetch single product datauseMerch()- Fetch product catalog with filteringuseProductImages(productId, colorId)- Fetch product images
- 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
Morbid Gene is a Swedish metal band formed in [2021]. Known for their melodic, crushing riffs and atmospheric soundscapes, they have performed across Sweden and are working on their way to the top.
For technical issues or questions:
- Contact: [cathrineohlsson@live.se]
For band-related inquiries:
- Use the contact form on the website
- Email: [morbidgenemusic@gmail.com]
Built with โค๏ธ and ๐ค by [Cathi]
This project represents the culmination of modern full-stack web development practices, combining React 19, Node.js, and MongoDB to create a production-ready e-commerce platform.