How to Submit Collection in GitHub?

This document provides a detailed guide for project teams on how to submit an application to list new collections on the UniSat Marketplace on Fractal.

  1. Prepare the contents of the two files, meta.json and inscriptions.json, for the collection.

  2. Sign in to GitHub and open https://github.com/unisat-wallet/fractal-ordinals-collections (templates for meta.json and inscriptions.json are available on this page).

  3. Click "Fork" on the page.

  1. It will automatically load the info for "Owner" and "Repository name" on the next page. Then click "Create fork".

  1. Wait a few seconds for the fork to be created. Once done, click "collections".

  1. Click "Add file" -> "Create new file".

  1. In the textbox below, create your collection folder. NOTE: The folder name must end with a /, for example, test1/. The folder name is the slug in the conllections meta.json.

  1. Create the file under the collection folder, enter meta.json in the textbox after the folder name as shown below, then copy/paste the related content of meta.json into the edit box. Finally, click "Commit changes...".

  1. You can check the left column to confirm that the meta.json file was created successfully.

  1. Use the same method to create the second file, inscriptions.json.

  1. Once both files are added, click the "Pull requests" tab -> "New pull request".

  1. If the page shows a green "Able to merge" message, click "Create pull request".

  1. Add a title and description (optional), then click "Create pull request".

  1. All done! You can find your request listed under "Pull requests".

Please keep the following in mind when submitting your request:

  • Be patient while we process your request.

  • Pay attention to the comments in your request. If your submission doesn't meet the requirements, we will specify the reason, and requests with invalid JSON files will be closed.

  • Do not repeatedly submit requests.

  • Submit a complete collection in one request. Do not spread files across multiple requests.

  • Do not submit multiple collections in one request. If one collection doesn't meet the criteria, it could affect the approval of others in the same request.

Last updated