Skip to content

waforix/wrapped-main-web

Repository files navigation

Wrapped - Main Website

Welcome to Wrapped

License: MIT TypeScript React Tailwind CSS

The official website for Wrapped - a Discord analytics and automation platform serving 10,000+ users. This modern, responsive website showcases our bot features, developer tools, and provides a comprehensive user experience.

πŸ’‘ Frequent and impactful contributors may be considered for invitations to work on the main Wrapped platform: Dash.wrapped.site

🌟 Features

  • Modern Design: Clean, professional interface with smooth animations
  • Responsive Layout: Optimized for all devices and screen sizes
  • Theme System: Dynamic theme switching with custom color palettes
  • Developer Tools: 22+ integrated web-based utilities
  • Performance Optimized: Fast loading with efficient code splitting
  • SEO Friendly: Comprehensive meta tags and structured data
  • Accessibility: WCAG 2.1 compliant with full keyboard navigation

πŸš€ Quick Start

Prerequisites

  • Bun (recommended) or Node.js 18+
  • Git

Installation

# Clone the repository
git clone https://github.com/WxTaco/main-website.git
cd main-website/main-web

# Install dependencies
bun install

# Start development server
bun run dev

# Build for production
bun run build

# Preview production build
bun run preview

Docker Deployment

# Build and run with Docker Compose
docker compose up -d

# View logs
docker compose logs -f

# Stop container
docker compose down

πŸ“ Project Structure

main-web/
β”œβ”€β”€ public/                 # Static assets
β”‚   β”œβ”€β”€ bot-logo.png       # Bot icon
β”‚   └── logo.png           # Site logo
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/        # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ home/         # Homepage sections
β”‚   β”‚   β”œβ”€β”€ themes/       # Theme system
β”‚   β”‚   β”œβ”€β”€ tools/        # Developer tools
β”‚   β”‚   └── ui/           # Base UI components
β”‚   β”œβ”€β”€ data/             # Configuration and static data
β”‚   β”œβ”€β”€ hooks/            # Custom React hooks
β”‚   β”œβ”€β”€ pages/            # Page components
β”‚   β”œβ”€β”€ styles/           # Global styles and themes
β”‚   └── utils/            # Utility functions
β”œβ”€β”€ docker-compose.yml     # Docker configuration
β”œβ”€β”€ Dockerfile            # Container build instructions
└── nginx.conf            # Production server config

πŸ› οΈ Development

Available Scripts

  • bun run dev - Start development server
  • bun run build - Build for production
  • bun run preview - Preview production build
  • bun run lint - Run ESLint
  • bun run type-check - Run TypeScript compiler

Code Style

  • TypeScript: Strict mode enabled
  • ESLint: Configured with React and TypeScript rules
  • Prettier: Automatic code formatting
  • Tailwind CSS: Utility-first styling approach

🎨 Theme System

The website features a dynamic theme system allowing users to:

  • Choose from predefined themes
  • Create custom color palettes
  • Save preferences in localStorage
  • Apply themes across all components

Adding New Themes

// src/data/themes.ts
export const customTheme = {
  name: 'Custom Theme',
  colors: {
    primary: '#your-color',
    secondary: '#your-color',
    accent: '#your-color',
    background: {
      start: '#your-color',
      end: '#your-color'
    }
  }
}

πŸ”§ Developer Tools

The website includes 22+ integrated developer tools:

  • JSON Debugger & Formatter
  • Color Palette Generator
  • Markdown Editor & Preview
  • Base64 Encoder/Decoder
  • URL Encoder/Decoder
  • Hash Generator (MD5, SHA)
  • QR Code Generator
  • And many more...

Adding New Tools

  1. Create tool component in src/components/tools/
  2. Add tool metadata to src/data/tools.ts
  3. Register route in src/App.tsx

πŸ“± Responsive Design

The website is fully responsive with breakpoints:

  • Mobile: 320px - 768px
  • Tablet: 768px - 1024px
  • Desktop: 1024px+

πŸš€ Deployment

Production Build

bun run build

Docker Deployment

The project includes Docker configuration for easy deployment:

# Build image
docker build -t wrapped-web .

# Run container
docker run -p 40125:40125 wrapped-web

Environment Setup

For production deployment, ensure:

  • Environment variables are properly set
  • SSL certificates are configured
  • CDN is set up for static assets
  • Monitoring and logging are enabled

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Contribution Steps

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ†˜ Support

πŸ™ Acknowledgments


Built with ❀️ by Taco

About

The main website for the Wrapped analytics bot and automations platform.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published