Where mystical energy meets modern commerce
TheVoidShop is a headless Shopify integration for alternative music and mystical merchandise. Built with React, TypeScript, and cosmic energy.
- Headless Shopify Integration - Manage products through Shopify admin
- Moon Phase Tracking - Live lunar cycle information
- Mystical Product Enhancement - Rarity levels, energy alignment, ritual uses
- Alternative Music Focus - Underground sounds and dark aesthetics
- Responsive Design - Mobile-first with dark, ethereal UI
Frontend:
- React 18 + TypeScript
- Tailwind CSS
- Vite
Backend:
- Express.js + TypeScript
- Shopify API v7.7.0
- RESTful architecture
Deployment:
- Frontend: Netlify
- Backend: Railway/Heroku
# Install dependencies
npm install
cd frontend && npm install
# Start backend (port 3000)
npm run dev
# Start frontend (port 5173)
npm run frontend- Live Moon Phases - Current lunar cycle with countdown to full moon
- Zodiac Integration - Moon sign calculations
- Energy Tracking - Mystical energy levels (flowing, surging, stable, chaotic)
- Rarity System - common, rare, legendary, cosmic products
- Ritual Enhancements - Special properties for mystical items
Products are enhanced with mystical metadata using Shopify tags:
ritual-protection → Ritual use: protection
limited-edition → Limited edition flag
rarity-legendary → Rarity level: legendary
energy-lunar → Energy alignment: lunar
Set up your .env file:
# Shopify Configuration
SHOPIFY_API_KEY=your_api_key
SHOPIFY_API_SECRET=your_api_secret
SHOPIFY_SHOP_DOMAIN=your-shop.myshopify.com
SHOPIFY_ACCESS_TOKEN=your_access_token
# Server Configuration
PORT=8080
NODE_ENV=production- Fork the repository
- Create your mystical feature branch (
git checkout -b feature/cosmic-enhancement) - Commit your changes (
git commit -m '🔮 Add cosmic enhancement') - Push to the branch (
git push origin feature/cosmic-enhancement) - Open a Pull Request
MIT License - See LICENSE for details.
Built with 🌙 mystical energy by [Your Name]