WPydia Repository Documentation

Create your own repository for Windows Phone 7 packages

📁 Repository Structure

Your repository needs to be a single JSON file hosted on a web server. The file should be accessible via a URL like:

http://yourdomain.com/repo.json
Note: The file must be publicly accessible and return valid JSON with the correct MIME type application/json.

📋 JSON Schema

Here's the complete structure of the repository JSON file:

{
  "name": "Your Repository Name",
  "description": "A short description of your repository",
  "url": "http://yourdomain.com",
  "maintainer": "Your Name",
  "packages": [
    {
      "id": "1",
      "name": "Your App Name",
      "description": "A brief description of what your app does",
      "version": "1.0.0",
      "price": "free",
      "section": "Utilities",
      "author": "Your Name",
      "depends": "wp7",
      "downloadurl": "http://yourdomain.com/apps/yourapp.xap",
      "icon": "http://yourdomain.com/icons/appicon.png"
    }
  ],
  "sections": [
    {
      "name": "Utilities",
      "description": "Useful tools and applications"
    }
  ],
  "metadata": {
    "last_updated": "2024-03-14T00:00:00Z",
    "package_count": 1,
    "supported_architectures": ["wp7"]
  }
}

🔧 Field Descriptions

Repository Level Fields

Field Type Description
name string Your repository name (e.g., "8NetLive Repo")
description string Brief description of your repository
url string Your website URL
maintainer string Your name or username

Package Fields

Field Type Description
id string Unique identifier for the package
name string Display name of the app
description string Detailed description of the app
version string App version (e.g., "1.0.0")
price string "free" or price with currency (e.g., "$1.99")
section string Category (must match one of your sections)
author string App developer name
depends string Platform requirement ("wp7", "wp8", "wm10", etc.)
downloadurl string Direct link to the .xap or .appx file
icon string URL to app icon image

Section Fields

Field Type Description
name string Section name (e.g., "Utilities", "Themes")
description string Description of what belongs in this section

📱 Sample Apps

📱 Sample App 1: Weather App

{
  "id": "101",
  "name": "SimpleWeather",
  "description": "Simple and lightweight weather app for Windows Phone 7. Get current conditions and 5-day forecast.",
  "version": "2.1.0",
  "price": "free",
  "section": "Utilities",
  "author": "WeatherDev",
  "depends": "wp7",
  "downloadurl": "http://yourdomain.com/apps/SimpleWeather.xap",
  "icon": "http://yourdomain.com/icons/weather.png"
}

🎨 Sample App 2: Theme Pack

{
  "id": "201",
  "name": "Dark Theme Pro",
  "description": "Beautiful dark theme with custom accents and wallpapers. Transform your phone's look completely.",
  "version": "1.5.0",
  "price": "free",
  "section": "Themes",
  "author": "ThemeMaster",
  "depends": "wp7",
  "downloadurl": "http://yourdomain.com/apps/DarkTheme.xap",
  "icon": "http://yourdomain.com/icons/theme.png"
}

🔧 Sample App 3: System Tool

{
  "id": "301",
  "name": "Registry Editor",
  "description": "Advanced registry editor for power users. Modify system settings with caution.",
  "version": "1.0.0",
  "price": "free",
  "section": "Homebrew Mods",
  "author": "DevPro",
  "depends": "wp7",
  "downloadurl": "http://yourdomain.com/apps/RegEdit.xap",
  "icon": "http://yourdomain.com/icons/regedit.png"
}

📦 Complete Repository Example

Here's a complete example with multiple apps and sections:

{
  "name": "WP7 Revival Repository",
  "description": "Collection of classic Windows Phone 7 apps and tools",
  "url": "http://wp7revival.atwebpages.com",
  "maintainer": "CND",
  "packages": [
    {
      "id": "1",
      "name": "SimpleWeather",
      "description": "Lightweight weather app with current conditions and forecast",
      "version": "2.1.0",
      "price": "free",
      "section": "Utilities",
      "author": "WeatherDev",
      "depends": "wp7",
      "downloadurl": "http://wp7revival.atwebpages.com/apps/SimpleWeather.xap",
      "icon": "http://wp7revival.atwebpages.com/icons/weather.png"
    },
    {
      "id": "2",
      "name": "Dark Theme Pro",
      "description": "Complete dark theme with custom accents",
      "version": "1.5.0",
      "price": "free",
      "section": "Themes",
      "author": "ThemeMaster",
      "depends": "wp7",
      "downloadurl": "http://wp7revival.atwebpages.com/apps/DarkTheme.xap",
      "icon": "http://wp7revival.atwebpages.com/icons/theme.png"
    },
    {
      "id": "3",
      "name": "Registry Editor",
      "description": "Advanced system registry editor",
      "version": "1.0.0",
      "price": "free",
      "section": "Homebrew Mods",
      "author": "DevPro",
      "depends": "wp7",
      "downloadurl": "http://wp7revival.atwebpages.com/apps/RegEdit.xap",
      "icon": "http://wp7revival.atwebpages.com/icons/regedit.png"
    }
  ],
  "sections": [
    {
      "name": "Utilities",
      "description": "Useful tools and applications"
    },
    {
      "name": "Themes",
      "description": "Wallpapers, accents, and visual customization"
    },
    {
      "name": "Homebrew Mods",
      "description": "System modifications and advanced tools"
    }
  ],
  "metadata": {
    "last_updated": "2024-03-14T12:00:00Z",
    "package_count": 3,
    "supported_architectures": ["wp7", "wp8"]
  }
}

🌐 Hosting Your Repository

Option 1: Free Hosting (AwardSpace)

  1. Sign up for a free account at AwardSpace
  2. Create a new website or use your existing subdomain
  3. Upload your repo.json file to the public_html folder
  4. Create folders for apps and icons if needed
  5. Your repository URL will be: http://yourusername.atwebpages.com/repo.json

Option 2: GitHub Pages ( Only WP8+ will works with the repo / windows 10+ works )

  1. Create a GitHub repository named yourusername.github.io
  2. Upload your repo.json file
  3. Your repository URL will be: https://yourusername.github.io/repo.json
Important: Make sure your .xap files are hosted somewhere accessible and the URLs in downloadurl fields are correct and downloadable.

✅ Validation Checklist

🔍 Testing Your Repository

To test if your repository is working:

  1. Open WPydia on your Windows Phone
  2. Go to the "sources" tab
  3. Click "edit sources" and add your repository URL
  4. Wait for packages to load
  5. Check the "changes" tab for any error messages

You can also test directly in your browser by visiting your repo.json URL - you should see the JSON data.

🆘 Troubleshooting

Common Issues:

Problem Solution
"Failed to load source" error Check if your JSON file is accessible and valid. Try opening the URL in a browser.
No packages shown Verify the "packages" array in your JSON has valid entries and "depends" field is set to "wp7".
Download link doesn't work Test the download URL directly in a browser. Make sure .xap files are hosted correctly.
Icons not showing Ensure icon URLs are direct links to image files (.png, .jpg) and are publicly accessible.
📄 Print Documentation 📥 Download Template