🌐 Kaman Web Browser

A lightweight, multi-tabbed desktop web browser built with C# and WinForms, powered by the Microsoft Edge WebView2 engine (Chromium). Supports tab management, smart search/navigation, and a clean user interface.

---

🚀 Purpose & Target Audience

This project is designed for "Lightweight local browsing with tab support":

Audience	Usage Method
End Users	Run the compiled .exe file for a simple, tabbed browsing experience.
Developers	Study the source code to understand WebView2 integration and WinForms UI logic.

---

✨ Key Features

• 🌐 Multi-Tab Support:
  • Open, switch, and close multiple tabs seamlessly.
  • Dynamic tab titles that update automatically with page content.
• 🔍 Smart Navigation & Search:
  • Auto-Detect: Type a URL (e.g., google.com) or a search query.
  • Smart Routing: Automatically adds https:// if missing and searches on Google if no URL is detected.
• 🔄 Full Navigation Controls:
  • Back / Forward: Traverse browsing history.
  • Refresh / Stop: Reload or halt page loading.
  • New Tab / Close Tab: Manage tabs with single clicks.
• 🎨 Clean & Responsive UI:
  • Built with Windows Forms for a native Windows look.
  • Double-Buffered: Prevents flicker and ensures smooth rendering.
  • Transparent WebView2: Properly handles background colors to avoid black borders.
• 🛡️ Robust Error Handling:
  • Graceful handling of navigation failures and engine initialization errors.
  • Optimized memory management (disposal of closed tabs to prevent leaks).

---

🛠 Tech Stack & Libraries

Technology	Role
C# (.NET Framework 4.8)	Core programming language
Windows Forms	Desktop UI Framework
Microsoft.Web.WebView2	Embedded Chromium-based browser engine (Edge)
System.Windows.Forms.TabControl	Multi-tab management
async/await	Non-blocking UI operations for navigation

---

📥 Installation & Setup

1. For End Users (Compiled Executable)

Prerequisite: Windows 10/11 with Microsoft Edge WebView2 Runtime installed (usually pre-installed on modern Windows).

1. Download the latest release (Web browser.exe) from the Releases page.
2. Run the executable.
3. Type a URL or search query in the address bar and press Enter!

2. For Developers (Source Code)

# Clone the repository
git clone https://github.com/Mohammad-Hasan-Kaman/web-browser.git
cd Web_browser

# Open in Visual Studio
# Open "Web browser.sln"
# Right-click Solution -> "Restore NuGet Packages" (installs WebView2)
# Press F5 to run

---

📝 How to Use

1. Launch the App: Run the executable.
2. Navigate: Type a URL (e.g., github.com) or a search term in the top bar.
3. Open New Tab: Click the New Tab button or use the shortcut.
4. Close Tab: Click the Close Tab button (keeps at least one tab open).
5. Navigate History: Use Back and Forward buttons to browse history.

---

📂 Project Structure

Web_browser/
├── Form1.cs             # Main logic: Tab management, navigation, event handling
├── Form1.Designer.cs    # UI layout (WinForms controls)
├── Program.cs           # Entry point
├── Properties/          # App resources and settings
├── packages/            # NuGet packages (WebView2)
├── LICENSE              # MIT License
├── README.md            # This file
└── Web browser.sln      # Visual Studio Solution

---

🤝 Contributing

Found a bug or have a suggestion? Please open an Issue. Contributions are welcome!

---

⭐ Support

If you find this tool useful, please give it a star! ⭐

---

Maintained by Mohammad Hasan Kaman | Last updated: July 2026

Disclaimer: This is a lightweight browser client built for educational purposes. It relies on the Microsoft Edge WebView2 engine. For full browsing features, ensure the WebView2 Runtime is installed.