🌐 Vanilla DNS Changer

Open-source DNS Changer for Windows, macOS, and Linux

A secure, fast, and beautiful DNS changer application with 40+ DNS servers support.

🖥️ Desktop App • ⌨️ CLI Tool • 🌐 Website

🇮🇷 نسخه فارسی

---

🌟 Default: Vanilla DNS

This app comes pre-configured with Vanilla DNS - a smart and fast bypass DNS service from Iran.

• Primary Server: 10.139.177.21
• Secondary Server: 10.139.177.22

For more information visit vanillapp.ir

---

✨ Features

• 🚀 One-Click DNS Change - Connect to any DNS server instantly
• 📊 40+ DNS Servers - Curated database of public DNS servers
• 🎨 Modern UI - Beautiful dark theme with Kick-style green accents
• 🖥️ Cross-Platform - Windows, macOS, and Linux support
• 🔒 Open Source - Fully transparent and community-driven
• ⚡ Fast & Lightweight - Minimal resource usage
• 🌍 Multi-Language - English and Persian (فارسی) support
• 📡 Server Ping - Test server latency before connecting
• 💾 Custom DNS - Add and save your own DNS servers
• 🔄 Auto-Sync - Automatic server list updates from GitHub

---

📦 Packages

This monorepo contains:

Package	Description	Status
@vanilla-dns/desktop	Electron desktop application	🚧 In Development
@vanilla-dns/cli	Command-line interface tool	🚧 In Development
@vanilla-dns/website	Landing page & documentation	🚧 In Development
@vanilla-dns/shared	Shared utilities & types	🚧 In Development

---

🖥️ Desktop App

Beautiful Electron-based desktop application with system tray support.

Features

• Modern dark UI with green accents (Kick-style)
• System tray with quick actions
• Auto-start with system
• Flush DNS cache
• Network interface selection
• Auto-updates

Download

Coming soon! Check Releases

---

⌨️ CLI Tool

Powerful command-line interface for DNS management.

Installation

npm install -g @vanilla-dns/cli

Usage

# Connect to DNS server interactively
vdns connect

# Connect by server name
vdns connect -n cloudflare

# Connect with custom DNS
vdns connect -s 8.8.8.8,8.8.4.4

# Connect to random server
vdns connect -r

# Disconnect (restore default DNS)
vdns disconnect

# Check current DNS status
vdns status

# List available servers
vdns list

# Ping a server
vdns ping cloudflare

# Flush DNS cache
vdns flush

---

🛠️ Development

Prerequisites

• Node.js >= 18
• pnpm >= 8

Setup

# Clone the repository
git clone https://github.com/Vanilla-DNSChanger/vanilla-dns-changer.git
cd vanilla-dns-changer

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Start development
pnpm dev

Project Structure

vanilla-dns-changer/
├── apps/
│   ├── desktop/     # Electron app
│   ├── cli/         # CLI tool
│   └── website/     # Landing page
├── packages/
│   └── shared/      # Shared code
├── package.json
├── pnpm-workspace.yaml
└── turbo.json

Scripts

pnpm build          # Build all packages
pnpm dev            # Start development mode
pnpm lint           # Run linting
pnpm test           # Run tests
pnpm clean          # Clean all builds
pnpm desktop dev    # Run desktop app in dev mode
pnpm cli dev        # Run CLI in dev mode
pnpm website dev    # Run website in dev mode

---

🎨 Design

Vanilla DNS Changer uses a Kick-style dark theme:

Color	Hex	Usage
🟢 Primary Green	#53FC18	Accents, buttons, highlights
⚫ Background	#0a0a0a	Main background
🔘 Card	#141414	Card backgrounds
📝 Border	#2a2a2a	Borders, dividers
⚪ Text	#ffffff	Primary text
🔘 Muted	#888888	Secondary text

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

---

📄 License

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

---

👤 Author

SudoLite

• Twitter/X: @sudolite
• GitHub: @Vanilla-DNSChanger

---

Made with 💚 by SudoLite

⭐ Star this repo if you find it useful!