iOS WebView Template

A lightweight native iOS template for creating apps with WKWebView that load local HTML/CSS/JS assets.

🚀 Quick Start

Requirements:

• macOS with Xcode 15+
• iOS 14.0 or later

Setup:

1. Create New iOS Project in Xcode:

   • Open Xcode → "Create New Project"
   • Choose "App" template
   • Product Name: Your App Name
   • Interface: SwiftUI
   • Language: Swift
   • Minimum iOS: 14.0

2. Add Web Files:

   • Delete placeholder files in WebAssets/ folders
   • Add your actual files:
     • HTML: WebAssets/HTML/ (must include index.html)
     • CSS: WebAssets/CSS/
     • JS: WebAssets/JS/
     • Images: WebAssets/Images/

3. Replace Code:

   • Replace App.swift with WebViewApp.swift
   • Replace ContentView.swift with provided file
   • Ensure WebAssets folder is added to project bundle

4. Build & Run in Xcode

📁 Project Structure

iOS WebView App/
├──WebViewApp.swift          # Main app structure
├──ContentView.swift         # WebView container
└──WebAssets/               # Web content (add to Xcode bundle)
├── HTML/
│   └── index.html       # Main HTML file (required)
├── CSS/                 # Stylesheets
├── JS/                  # JavaScript
└── Images/              # Images

🔧 Key Features

• ✅ Lightweight - Native WKWebView, no heavy frameworks
• ✅ Local Assets - Loads HTML/CSS/JS from app bundle
• ✅ JavaScript Enabled - Full web functionality
• ✅ SwiftUI - Modern iOS development
• ✅ iOS 14+ - Broad device compatibility

📱 Building

1. Open project in Xcode
2. Connect iOS device or use simulator
3. Product → Run (⌘R)

🔗 Web Asset References

In your HTML files, reference assets like:

<link rel="stylesheet" href="../CSS/style.css">
<script src="../JS/app.js"></script>
<img src="../Images/logo.png">

⚠️ Important Notes

· Main HTML file must be named index.html · WebAssets folder must be added to app bundle in Xcode · Test on actual device for full performance · App size: ~2-5MB (depending on your web content)

📄 License

[Add your license here]