NeoVitaDB

developer guide
< Back to catalog

For developers

Add your homebrew to NeoVitaDB

Share your PS Vita or PSP project with the community. The catalog stores your project details and CI resolves release information automatically.

Add an entry

Use the step-by-step generator on the test catalog

New entries go through the test catalog first and get promoted here once reviewed. Head over there for a guided tool that reads your vpk and icon and builds a ready-to-submit package for your pull request.

Open the entry generator on the test catalog
01

Create an entry

Copy the platform template and save it under apps/vita/ or apps/psp/ using the next available id.

02

Add your icon

Place a matching 128x128 PNG in icons_vita/ or icons_psp/. Use the same filename as the entry slug.

03

Open a pull request

Describe the project, link its GitHub repository, and let CI validate the metadata before it is published.

Read the full contribution guide

Entry example

{
  "id": 42,
  "name": "My Homebrew",
  "author": "Your Name",
  "category": "game",
  "platform": "vita",
  "titleid": "MYHB00001",
  "repo": "youruser/your-repo",
  "asset": "*.vpk",
  "icon": "0042-my-homebrew.png",
  "description": "What it does."
}
Keep in mind

Version, release date, size, download count, checksums, and download URL are filled from your latest GitHub release. The trusted flag is recalculated from repository stars.

For catalog users

How this repository works

This is a static catalog. Consume the generated feeds and hosted assets from GitHub Pages; use the repository files when you need contributor metadata or want to build your own catalog.

Generated catalog feeds

These are the recommended endpoints for an app or website. Each item contains its resolved version, release data, download URL, checksums, and metadata.

https://robin994.github.io/NeoVitaDB-Catalog/vita.json https://robin994.github.io/NeoVitaDB-Catalog/psp.json

Hosted icons

Use the icon filename from a feed item. Vita icons are published at /icons/; PSP icons are published at /icons_psp/.

https://robin994.github.io/NeoVitaDB-Catalog/icons/0001-neovitadb-downloader.png https://robin994.github.io/NeoVitaDB-Catalog/icons_psp/0001-example.png

Repository source files

Contributor entries and original icons are kept in the repository. These paths are useful for inspection, but generated feeds are more stable for catalog clients.

https://raw.githubusercontent.com/robin994/NeoVitaDB-Catalog/main/apps/vita/0001-neovitadb-downloader.json https://raw.githubusercontent.com/robin994/NeoVitaDB-Catalog/main/icons_vita/0001-neovitadb-downloader.png

Using a fork

Replace the owner and repository name in every hosted URL after enabling GitHub Pages with the GitHub Actions source on your fork.

https://your-user.github.io/your-catalog/vita.json https://your-user.github.io/your-catalog/icons/your-icon.png