World Vibe Web (wvw.dev) is a distributed app store that aggregates vibe-coded projects from GitHub. To get your apps listed, you need to create an apps.json file following a specific schema — but writing JSON by hand is error-prone and tedious.
This generator gives you a visual form builder that produces valid, schema-compliant apps.json files instantly. Fill in your store info, add your apps one by one, and the tool handles formatting, validation, and category mapping automatically. It supports all 27 WVW-recognized categories, auto-generates kebab-case IDs, fetches repo details from the GitHub API, and saves your progress automatically.
Whether you're listing a single CLI tool or an entire portfolio of projects, this tool ensures your apps.json is correct before you submit your PR to wvw.dev. Read our complete guide on creating apps.json for wvw.dev for step-by-step instructions and tips.
## WVW Submission Tips - Use the Load Demo button to see a complete example with 3 apps before creating your own listing. - Auto-fill from GitHub saves time by fetching repo metadata, but always review and customize the description for better discoverability. - Only the 27 WVW-recognized categories will appear on wvw.dev. Unrecognized categories are stripped during the build process. - Keep app IDs as lowercase kebab-case identifiers. The auto-generate feature handles this formatting for you. - Check your apps.json sync status using the WVW Store Checker tool after submitting to verify your apps appear on wvw.dev. ## Frequently Asked Questions ### What is wvw.dev? WVW (World Vibe Web) is a distributed app store that aggregates vibe-coded projects from GitHub repositories. Developers maintain their own apps.json file, and WVW's build system pulls them all together into a unified catalog at wvw.dev. ### What is an apps.json file? An apps.json file is a JSON document that describes your app store and the apps in it. It includes store metadata (name, developer), categories, and an array of app entries with details like name, description, platform, and GitHub URL. ### Which categories are allowed on WVW? WVW recognizes 27 categories including macOS Apps, Web Apps, CLI Apps, Developer Tools, Productivity, Utilities, Games, and more. Apps with unrecognized categories will have those categories stripped during the WVW build. This tool only shows the 27 allowed categories. ### How do I submit my apps to wvw.dev? After creating your apps.json, commit it to a public GitHub repo. Then open a pull request to f/wvw.dev adding your repo path to stores.json. After the PR is merged, WVW will fetch your apps every 6 hours. ### Can I run my own standalone store? Yes! You don't need to submit to WVW. You can clone the Appetit project (github.com/f/appetit), replace the apps.json with yours, and deploy it to any static host like GitHub Pages, Netlify, or Vercel. ### Does this tool validate the apps.json schema? Yes. The tool validates all required fields, checks category names against the 27 WVW-recognized categories, verifies URL formats, and ensures app IDs are valid kebab-case identifiers. Validation errors are shown before you can export. ### Can I auto-fill app details from GitHub? Yes. Enter a GitHub repository URL and click Auto-fill from GitHub. The tool fetches the repo name, description, language, and other metadata from the GitHub API to populate the form fields automatically. ### Is my progress saved automatically? Yes. Your store information and all apps are auto-saved to your browser's local storage. When you return to the page, your last session is restored. You can also start fresh at any time. ### How long does it take for my apps to appear on wvw.dev? After your pull request to wvw.dev is merged, WVW fetches your apps.json every 6 hours during its automated build cycle. Your apps should appear within the next build after the merge. ### Can I list paid apps or only ones? You can list both and paid apps. The price field accepts values like '', '$9.99', or any text. WVW displays the price as-is in the app listing.