Solutions to common issues with image generation and uploads.
An image I asked for wasn't generated
A few things can cause this:
- The content was flagged. If the image generator's safety filters flag a requested image (for example, content involving real people, copyrighted characters, or sensitive material), that image is silently skipped. The build continues without it.
- The build hit the limit. Each build generates up to 10 images. If your app called for more than that, the list was trimmed. Try breaking your request into smaller builds or reducing the number of images in one go.
- The AI decided the app didn't need it. Image generation is based on the AI's interpretation of what your app would benefit from. If you want a specific image, describe it explicitly in your prompt rather than assuming the AI will include it.
An image looks wrong or isn't what I asked for
Describe what you want changed in the chat. Be specific about the style, colors, composition, or content: "Regenerate the hero image — I want it to show an aerial view of a city at night, not a daytime shot."
The AI will create a new version with the next build.
My logo has a gray or white checkerboard background instead of transparency
This happens when you ask for a transparent background but the image has a visible checkerboard pattern instead of true transparency. Caffeine has a processing step that removes checkerboard patterns from logos and icons — but it needs to know the image should be transparent.
Make sure your prompt includes the word "transparent" or "transparent background" when requesting logos or icons. For example: "Generate a circular logo with a transparent background." If the checkerboard is still showing after a rebuild, contact support.
The AI generated an SVG but it's not rendering
SVG generation isn't supported. If the AI planned an SVG file, it is automatically converted to a PNG before the build completes. What you see in your app will be a PNG, even if you asked for an SVG. This is expected behavior.
If you need a true vector asset, you can upload an SVG file yourself as a project asset, and the AI will reference it in the generated code.
An uploaded image isn't appearing in my app
If you uploaded an image and the AI didn't use it:
- Make sure you described clearly how you want it used: "Put this image as the background of the hero section" or "Use this as the app logo in the header."
- Try uploading the image again in a follow-up message with a more explicit instruction.
If the file was larger than 10 MB, the upload would have been rejected. Check that your file is within the limit and try again.
I uploaded a HEIC file and it didn't work
HEIC files (common on iPhone) are automatically converted to JPEG during upload. If the conversion failed, try converting the file to JPEG or PNG on your device before uploading.
An image generation failure caused my whole build to fail
It shouldn't. Image generation failures are non-blocking — if an individual image can't be generated, it is skipped and the rest of the build continues. If your build failed and you suspect images were involved, contact support with your project name and the approximate time of the build.
I need a logo for a well-known brand (Facebook, Instagram, GitHub, etc.)
Caffeine deliberately does not generate logos for well-known brands — that would produce inaccurate or off-brand results. Instead, these are rendered using standard icon libraries (react-icons), which provide crisp, official-looking icons for hundreds of platforms. You don't need to ask for this specifically — the AI uses the icon library automatically for recognized brand logos.