Thanks to visit codestin.com
Credit goes to github.com

Skip to content

x32u/mars-website

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

✨ Mars~

A Dreamy Discord Bot Website

πŸŒ™ Bringing magic to your server with natural language understanding πŸŒ™

Next.js TypeScript CSS Modules Vercel

🌐 Live Website β€’ πŸ“‹ Commands β€’ πŸ€– Invite Bot β€’ πŸ’¬ Support


Mars Preview

🌟 About Mars

Mars is a versatile Discord bot that understands natural language and brings a touch of magic to your server! With a dreamy pink and purple aesthetic, Mars offers economy commands, utilities, and moderation tools that make server management both fun and efficient.

✨ Bot Features

πŸ›οΈ Economy System

  • Dream dust currency system with daily rewards
  • Item foraging and magical brewing
  • Shop and inventory management
  • Gift sharing between friends

πŸ› οΈ Utility Commands

  • Weather lookups for any location
  • Interactive polls and voting
  • Server ping monitoring

πŸ›‘οΈ Moderation Tools

  • Message purging and cleanup
  • Channel management utilities
  • Permission handling

οΏ½ Website Features

🏠 Beautiful Homepage

  • Animated starry background with floating particles and gradient orbs
  • Responsive design optimized for all devices and screen sizes
  • Dreamy Mars-themed color palette with pink/purple gradients
  • Smooth scroll animations with intersection observer
  • Feature cards with hover effects and fade-in animations

πŸ“‹ Interactive Commands Page

  • Real-time search across command names, descriptions, arguments, and permissions
  • Category filtering with dynamic count updates
  • Keyboard shortcuts (Ctrl+K to search, Escape to clear)
  • Mobile-optimized interface with touch-friendly controls
  • Command copying with one-click slash command copying
  • No results state with helpful suggestions

πŸš€ Modern Tech Stack

  • Next.js 15 with App Router for optimal performance
  • TypeScript for complete type safety
  • CSS Modules for scoped component styling
  • Mobile-first responsive design approach
  • SEO optimized with proper meta tags and OpenGraph

�️ Development

Prerequisites

  • Node.js 18+
  • npm, yarn, or pnpm

Getting Started

# Clone the repository
git clone https://github.com/HaruRee/mars-website.git
cd mars-website

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:3000 to view the website.

Available Scripts

npm run dev      # Start development server with hot reload
npm run build    # Build optimized production bundle
npm run start    # Start production server
npm run lint     # Run ESLint for code quality

πŸ“ Project Structure

mars-website/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ commands/              # Commands page with search
β”‚   β”‚   β”‚   β”œβ”€β”€ page.tsx          # Commands page component
β”‚   β”‚   β”‚   └── commands.module.css # Scoped CSS styles
β”‚   β”‚   β”œβ”€β”€ globals.css           # Global Mars theme styles
β”‚   β”‚   β”œβ”€β”€ layout.tsx            # Root layout with metadata
β”‚   β”‚   └── page.tsx              # Homepage component
β”‚   └── components/               # Reusable React components
β”‚       β”œβ”€β”€ AnimatedBackground.tsx # Starry background effect
β”‚       β”œβ”€β”€ Header.tsx            # Navigation header
β”‚       └── Footer.tsx            # Site footer
β”œβ”€β”€ public/
β”‚   └── star.png                  # Mars logo asset
β”œβ”€β”€ package.json                  # Dependencies and scripts
└── README.md                     # This beautiful file!

🎨 Design System

Color Palette

--dreamy-primary: #fbbcff;     /* Dreamy Pink */
--dreamy-secondary: #c084fc;   /* Soft Purple */  
--dreamy-bg: #0f0f0f;         /* Deep Space */
--dreamy-surface: #1a1a1a;    /* Dark Surface */
--dreamy-accent: #2a2a2a;     /* Subtle Accent */
--dreamy-text: #ffffff;       /* Pure White */
--dreamy-muted: #a0a0a0;      /* Muted Gray */

Typography & Spacing

  • Clean sans-serif fonts for readability
  • Consistent spacing using CSS custom properties
  • Accessible contrast ratios (WCAG AA compliant)
  • Responsive typography that scales beautifully

Animation Philosophy

  • Subtle and elegant motion design
  • Performance-first with CSS transforms
  • Intersection observer for scroll-triggered animations
  • Reduced motion support for accessibility

πŸ› οΈ Built With

  • Next.js 15 - React framework with App Router
  • TypeScript - Type safety and better DX
  • Tailwind CSS - Utility-first CSS framework
  • React - Component-based UI library

πŸ“„ Pages

  • Homepage (/) - Hero section, features, stats, and animated background
  • Commands (/commands) - Interactive command browser with search and filtering

οΏ½ Deployment

The website is automatically deployed to Vercel when changes are pushed to the main branch.

Auto-Deploy Setup

  1. Connect your GitHub repository to Vercel
  2. Push changes to the main branch
  3. Vercel automatically builds and deploys
  4. Live updates in seconds! ⚑

Manual Deployment

# Build the project
npm run build

# Deploy to Vercel (install Vercel CLI first)
npm i -g vercel
vercel --prod

πŸ› οΈ Built With

Technology Purpose Version
Next.js React framework with App Router 15.3.4
TypeScript Type safety and developer experience 5.0+
CSS Modules Scoped styling without conflicts Latest
React Component-based UI library 18+

οΏ½ Pages Overview

🏠 Homepage (/)

  • Hero section with animated background
  • Feature showcase with hover effects
  • Bot statistics and highlights
  • Call-to-action sections

πŸ“‹ Commands (/commands)

  • Complete command browser
  • Real-time search and filtering
  • Category organization
  • Mobile-optimized interface

🀝 Contributing

We welcome contributions to make Mars even more magical! ✨

How to Contribute

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Guidelines

  • Follow TypeScript best practices
  • Use CSS Modules for styling
  • Ensure mobile responsiveness
  • Test across different browsers
  • Maintain the dreamy aesthetic! πŸŒ™

πŸ“ License

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

πŸ’« Acknowledgments

  • Built with ❀️ using Next.js and TypeScript
  • Inspired by the beauty of Mars and dreamy space aesthetics
  • Special thanks to the Discord.js and React communities
  • Font and icon resources from various open-source projects

Made with ✨ magic ✨ and lots of coffee by the Mars team

If you found this project helpful, please consider giving it a ⭐!

GitHub Stars GitHub Forks

🌟 Star this repo β€’ πŸ› Report Bug β€’ πŸ’‘ Request Feature

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published