# Offline Website Pro

> Ship the site inside the APK so it opens with no connection at all.

- **Applies to:** AppMint and Appwright
- **Source:** the Integration Guide shipped inside the app; this page is generated from it.
- **HTML:** https://freewebtoapk.com/docs/offline-website

Convert ZIP to High-Performance Offline App

### 1. Prepare Your Website Files

Collect all your HTML, CSS, JS, and image files into a single folder. Ensure your main entry file is named 'index.html'.

Tips:

- Use relative paths for all assets (e.g., <img src="images/logo.png">)
- Avoid absolute paths (e.g., /C:/Users/...)
- Keep filenames and folder names case-sensitive (Android is Linux-based)

### 2. Create a ZIP Archive

Compress your website files into a standard .zip archive.

Recommended structure:

- index.html
- style.css (optional)
- script.js (optional)
- images/... (optional)

✅ The generator accepts both:

1. ZIP with files directly at root
2. ZIP containing one parent folder (auto-detected)

⚠️ Avoid deep nesting like project/build/site/index.html unless that is your intended web root.

### 3. Quick Minimal Test (Exact)

Use this exact test to verify your setup:

1. Create a folder named test_site
2. Add one file named index.html
3. Paste your sample HTML into index.html
4. Zip it as test_site.zip
5. In Step 1, choose Offline ZIP and select test_site.zip
6. Generate APK and install

If this opens correctly, your pipeline is fine and larger-project blank screens are usually path or asset issues.

```
test_site.zip
└── index.html
```

### 4. Select Offline Mode _(AppMint only)_

In the Web2APK Generator (Step 1):

1. Select the 'Offline ZIP' radio button
2. Click the 'Choose Website ZIP' button
3. Select your prepared .zip file from your device storage

### 4. Select Offline Mode _(Appwright only)_

In Appwright (Step 1):

1. Select the 'Offline ZIP' radio button
2. Click the 'Choose Website ZIP' button
3. Select your prepared .zip file from your device storage

### 5. Generate Your APK

Complete the rest of the steps (App Name, Icon, Splash, etc.) and click 'Generate APK'. Your website will now run entirely offline without needing an internet connection!

### 6. Troubleshooting

❌ Blank screen? Open index.html in a browser first and check for JS errors.  
❌ Blank screen with simple ZIP? Rebuild with latest generator version (offline extraction fix included).  
❌ Broken images/CSS/JS? Verify paths are relative (./assets/logo.png), not absolute (/assets/logo.png or C:\...).  
❌ CSS not loading? Check exact filename case (style.css vs Style.css).  
❌ JS modules failing? Ensure module file paths exist in the ZIP.