BanBreaker

A premium, powerful tool by HEAVSTAL TECH™ to help you effectively appeal WhatsApp account and group bans.

Restore your access with intelligently crafted, high-success-rate appeals.

---

✨ Features

• ⚡ Multi-Tier Appeal System: Dedicated workflows for regular account bans, group bans, and legally-focused permanent ban appeals.
• 📚 Curated Templates: Access a library of high-success-rate appeal templates for various scenarios.
• 🤖 AI-Powered Assistant (Jeden): Get custom-generated appeals by describing your situation or uploading a screenshot of the ban message.
• 👁️ Screenshot Analysis: The AI uses Tesseract.js to read text directly from your ban screenshots for a more accurate appeal.
• 💾 Local Appeal History: All your sent appeals are logged securely in your browser's local storage for your reference.
• 🎨 Dynamic Theming: Switch between Dark Blue, Dark Yellow, and Dark Red themes to suit your style.
• 📱 Fully Responsive: A clean, modern UI that works perfectly on both desktop and mobile devices.

---

🛠️ Tech Stack

• Framework: Next.js
• Language: TypeScript
• Styling: Tailwind CSS
• AI Engine: Groq (for Llama 3.1)
• Image Recognition (OCR): Tesseract.js
• Deployment: Vercel

---

⚙️ Getting Started

Follow these instructions to set up and run the project locally.

Prerequisites

• Node.js (v18 or later)
• npm or yarn
• A Groq API Key for the AI Chatbot.

Installation

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/BanBreaker.git

2. Navigate to the project directory:

   cd BanBreaker

3. Install the dependencies:

   npm install

Environment Variables

For the AI Assistant to work, you need to provide your Groq API key.

1. Create a new file named .env.local in the root of your project.
2. Add your API key to this file:

   GROQ_API_KEY=gsk_YourSecretGroqApiKeyHere
   

Run the Development Server

Start the local development server with this command:

npm run dev

Open http://localhost:3000 in your browser to see the application.

---

🚀 Deployment

This app is optimized for deployment on Vercel.

1. Push your code to a GitHub repository.
2. Import the repository into Vercel.
3. Important: In your Vercel project settings, go to Settings > Environment Variables and add your GROQ_API_KEY with its value.
4. Deploy!

---

📜 License

This project is distributed under the MIT License. See LICENSE for more information.

Built with ❤️ by HEAVSTAL TECH™