Skip to content

aMathyzinn/BotClienty

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

24 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

BotClienty

πŸ€– Modern Web Client for Discord Bots

Next.js React TypeScript Discord API

GitHub Stars GitHub Forks License

Connect with your bot token, navigate servers/channels, view messages (embeds & attachments) and send messages in a clean UI inspired by Discord.

Features β€’ Quick Start β€’ Usage β€’ Tech Stack β€’ Contributing


✨ Features

Security
πŸ” Secure Authentication
Connect with bot token without third-party data sharing
Real-time
⚑ Real-time Updates
Messages and sending with instant updates
UI
🎨 Discord-inspired UI
Dark, responsive and modern layout

🌟 Core Capabilities

Feature Description Status
πŸ” Token Authentication Securely connect to your bot βœ… Ready
πŸ“± Responsive Layout Desktop / Tablet / Mobile support βœ… Ready
🎨 Modern Dark Theme Refined dark visual experience βœ… Ready
⚑ Real-time Updates View and send messages instantly βœ… Ready
πŸ–ΌοΈ Rich Content Support Embeds, attachments and media βœ… Ready
πŸš€ Next.js Performance Optimized build and static export βœ… Ready

🎬 Preview

πŸ”‘ Authentication Screen

Clean and straightforward bot token authentication

Login Screen

πŸ’¬ Chat Interface

Navigate guild tree, view embeds and attachments in real-time

Chat Interface

πŸ“± Responsive Design

Adaptive UI with consistent typography and spacing

Responsive Design

πŸš€ Quick Start

Prerequisites

Node.js 18+ npm 8+
# Check your versions
node --version  # 18.x or higher
npm --version   # 8.x or higher

Installation & Setup

# 1️⃣ Clone the repository
git clone https://github.com/amathyzinn/botclienty.git
cd botclienty

# 2️⃣ Install dependencies
npm install

# 3️⃣ Start development server
npm run dev

# 4️⃣ Open in browser
# http://localhost:3000

πŸ—οΈ Production Build

# Build for production
npm run build

# Artifacts in ./out ready for static hosting
npm run export

πŸ“– Usage Guide

Getting Your Bot Token

  1. Visit the Discord Developer Portal
  2. Create a new application or select an existing one
  3. Navigate to the Bot section
  4. Generate or copy your bot token
  5. ⚠️ Never share your token publicly

Application Flow

graph TD
    A[Enter Bot Token] --> B[Authenticate]
    B --> C[Load Servers]
    C --> D[Select Server]
    D --> E[Choose Channel]
    E --> F[View Messages]
    F --> G[Send Messages]
    G --> H[View Embeds & Media]
Loading

πŸ”’ Security Best Practices

βœ… Do ❌ Don't
Store tokens locally only Share tokens publicly
Use environment variables Commit tokens to git
Regenerate if compromised Use tokens in client-side code
Follow Discord ToS Abuse rate limits

πŸ› οΈ Tech Stack

Next.js
React Framework
React
UI Library
TypeScript
Type Safety
Discord API
Bot Integration

Architecture Overview

Frontend (Next.js + React + TypeScript)
    ↓
Discord API Integration
    ↓
Real-time Message Handling
    ↓
Responsive UI Components

πŸ“ Project Structure

botclienty/
β”œβ”€β”€ πŸ“ app/                 # Next.js App Router
β”‚   β”œβ”€β”€ 🎨 globals.css      # Global styles & theme
β”‚   β”œβ”€β”€ πŸ“„ layout.tsx       # Root layout component
β”‚   β”œβ”€β”€ 🏠 page.tsx         # Main page component
β”‚   └── πŸ“ api/             # API routes
β”‚       └── πŸ“ discord/     # Discord API integration
β”œβ”€β”€ πŸ“ public/              # Static assets
β”‚   └── πŸ–ΌοΈ logo.webp        # Application logo
β”œβ”€β”€ βš™οΈ next.config.js       # Next.js configuration
β”œβ”€β”€ πŸ“¦ package.json         # Dependencies & scripts
β”œβ”€β”€ πŸ”§ tsconfig.json        # TypeScript configuration
└── πŸ“– README.md            # This file

🎨 Design System

🎭 Color Palette

/* Dark Blue Theme */
:root {
  --primary-bg: #0F172A;      /* Main background */
  --secondary-bg: #1E293B;    /* Cards/panels */
  --accent-blue: #1E3A8A;     /* Primary accent */
  --accent-light: #3B82F6;    /* Light blue accent */
  --accent-dark: #1E40AF;     /* Dark blue accent */
  --text-primary: #F8FAFC;    /* Primary text */
  --text-secondary: #CBD5E1;  /* Secondary text */
  --hover-bg: #334155;        /* Hover states */
  --border-color: #475569;    /* Borders */
  --success-color: #10B981;   /* Success states */
  --error-color: #EF4444;     /* Error states */
  --warning-color: #F59E0B;   /* Warning states */
}

πŸ”€ Typography Scale

/* Inter Font Family */
font-family: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;

/* Type Scale */
--text-xs: 0.75rem;    /* 12px - Small labels */
--text-sm: 0.875rem;   /* 14px - Body small */
--text-base: 1rem;     /* 16px - Body */
--text-lg: 1.125rem;   /* 18px - Large body */
--text-xl: 1.25rem;    /* 20px - Small headings */
--text-2xl: 1.5rem;    /* 24px - Medium headings */
--text-3xl: 1.875rem;  /* 30px - Large headings */
--text-4xl: 2.25rem;   /* 36px - Extra large */

πŸ”’ Security & Privacy

Security Feature Implementation
πŸ” Local Token Storage Tokens stored locally, no third-party sharing
🌐 HTTPS Only All API calls use secure HTTPS connections
🚫 No Data Collection No external data collection or analytics
πŸ’Ύ Client-side Only All data remains on your device
πŸ”„ Token Rotation Support for easy token regeneration

Privacy Commitment

  • βœ… No tracking - We don't track your usage
  • βœ… No analytics - No third-party analytics services
  • βœ… No data sharing - Your bot data stays with you
  • βœ… Open source - Full transparency in our code

🧩 Customization

Theme Customization

// theme.config.ts
export const customTheme = {
  colors: {
    primary: '#1E3A8A',
    secondary: '#3B82F6',
    background: '#0F172A',
    surface: '#1E293B',
  },
  borderRadius: {
    sm: '0.375rem',
    md: '0.5rem',
    lg: '0.75rem',
    xl: '1rem',
  },
  spacing: {
    xs: '0.25rem',
    sm: '0.5rem',
    md: '1rem',
    lg: '1.5rem',
    xl: '2rem',
  },
};

Component Customization

// components/CustomCard.tsx
export function CustomCard({ children }: { children: React.ReactNode }) {
  return (
    <div className="bg-secondary-bg rounded-lg p-4 border border-border-color shadow-lg hover:shadow-xl transition-shadow">
      {children}
    </div>
  );
}

🀝 Contributing

We welcome contributions! Here's how you can help:

PRs Welcome Issues Welcome

Development Workflow

# 1️⃣ Fork the repository
# 2️⃣ Create a feature branch
git checkout -b feature/your-feature-name

# 3️⃣ Make your changes
# 4️⃣ Write descriptive commits
git commit -m "feat: add your feature description"

# 5️⃣ Push and create a Pull Request
git push origin feature/your-feature-name

Contribution Guidelines

  • πŸ“ Clear descriptions - Explain what and why
  • πŸ§ͺ Test your changes - Ensure everything works
  • πŸ“š Update documentation - Keep docs current
  • 🎨 Follow code style - Maintain consistency
  • πŸ” Review process - Be open to feedback

πŸ“Š Project Stats

GitHub Stats Top Languages

πŸ“„ License

MIT License

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


🌟 Support

⭐ Star this project if you find it helpful!

GitHub Website Portfolio Discord

Made with ❀️ for the Discord community β€” by aMathyzin

⬆️ Back to top


πŸš€ Ready to get started?

Get Started

About

Modern web client for Discord bots. Connect with your bot token, browse servers and channels, view messages with embeds and attachments, and send messages directly. Clean UI inspired by the official Discord app.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors