Retro Asset Studio is in alpha, and bug reports are the most useful thing you can send us. This page explains where to send them and what to include so we can fix things quickly.
Where to report¶
| Channel | Use it for |
|---|---|
| Issues at github.com/gameroadstudio/retro-asset-studio-feedback | Bugs, crashes, wrong behavior |
| Discussions in the same repository | Feature ideas, questions, workflow tips, showing off your assets |
| Email support@retroassetstudio.com | Anything you would rather not post publicly, or if you do not have a GitHub account |
The feedback repository contains no source code; it exists only for issues and discussions. Search existing issues before opening a new one and add a comment if yours is already there.
What to include in a bug report¶
The issue template in the repository asks for these fields. Filling them all in saves a round trip.
- App version -- Open Help > About Retro Asset Studio and copy the version (for example
0.1.0-alpha.1). Say whether you used the installer or the portable zip. - Windows version -- Press
Win+R, typewinver, and copy the version and build (for example "Windows 11 23H2, build 22631"). - AI provider and model -- Google Gemini and which model (for example
gemini-2.5-flash-image). Not needed for editing-only bugs. - Steps to reproduce -- A numbered list, starting from a fresh launch if possible. The more exact, the better.
- What happened and what you expected.
- Screenshots or a short recording -- Especially for visual problems in the editor or the pose canvas.
- The error message -- See below.
Capturing the error message¶
When something fails, the app shows an error notification in the bottom status bar. It has a copy button: click it and paste the exact message into the issue. Attach a screenshot of the notification as well if you can, and describe the steps that led to it and which provider and model were active.
Redact anything private before posting. Prompts you typed may appear in the message.
Data folder¶
If the problem is about projects not loading, imports, or missing files, tell us what is in your data folder:
%APPDATA%\Retro Asset Studio\data
Include the folder structure or the names of the affected project folders.
Never attach app.json
app.json is the application database and contains your API keys (encrypted, but still yours). Do not upload it to an issue, a discussion, or an email. If we need details from it, we will ask for specific fields you can copy by hand with the keys removed.
Reporting a crash¶
If the app closes on its own or shows a blank window:
- Note what you were doing right before.
- Try launching again; if it crashes at startup every time, try the
--disable-gpuworkaround in Troubleshooting and tell us whether it helped. - Include your GPU model and driver version if the Pose Editor or the pixel canvas was involved.
Feature requests¶
Post them in Discussions. Describe the problem you are trying to solve, not just the button you want; that helps us find a design that fits the rest of the app. Upvote existing threads instead of opening duplicates.
What happens next¶
We label and triage issues in the feedback repository. Fixes ship in the next alpha build, listed in the Changelog. There is no auto-update yet, so check the download page when an issue you follow is closed.