IMPORTER

FairFate is a level 99 Robotic Supreme Overlord Wizard with the ability to replicate an unprecedented amount of items at the same time. Use this to your advantage!

I know that many of you have spent years building up your libraries and storefronts on Itch.io, and I wanted to respect that time. I couldn’t imagine having 100 games in your back catalogue and having to recreate that on a new platform, so instead of making you start over, I built the Itch.io Importer to make migrating to or syncing with FairFate as painless as possible. This tool is designed to allow creators to easily bring their games over, and players to access their existing library.

HOW IT WORKS

1. Provide Your API Key: Start by providing your Itch.io API key. The system immediately validates the key, encrypts it, and stores it securely for future use. If you opt to do so, your key is then stored using Supabase’s Vault Feature. You can also use Oauth to access your Itch.io account, however I believe Oauth has its limitations with full access to your games.
2. Start the Import: Choose to import either the games you’ve purchased, or the games you’ve created.
3. Confirmation: The import runs in the background as an asynchronous process. Our service fetches your games, checks if they already exist on FairFate, and either creates a new game listing or maps to an existing one. You can track the progress of the import and see a full summary with stats when it’s complete, in your import history.
4. For Creators: Claiming Your Games: After you’ve imported your created games, there’s one final step: claiming them. This is a simple process that uses your API key or Oauth credentials to verify that you are the original creator of the Itch.io game. This officially links it to your FairFate account, and gives you management control.

WHAT WE IMPORT

When a new game is created from an Itch.io game, we bring over its key metadata to get you started, including:

• Title and description
• Cover image URL
• Pricing information

We also mapped Itch’s classifications to FairFate tags. For example, a game classified as a physical_game on Itch.io is automatically tagged with ttrpg on FairFate.

SECURITY & API ETIQUETTE

Your security is critical. As mentioned, your Itch.io API key is encrypted and never stored in plain text, using Supabase’s Vault Feature. We also built our client to be a good citizen, by rate-limiting its requests to one per second. This ensures that we don’t overload their servers; it’s also why this is an asynchronous process, so that you don’t have to wait for it to complete.