Darkroom

Added

• Reference images. Give the model up to 14 images to work from as well as the prompt: a style to copy, a product to show, a person or a room to keep. Upload them, drop them on the prompt, or choose them from any asset container you can view, and refer to them in the prompt by number ("in the style of image 1"). Uploads are reduced to a JPEG, kept for a day outside the web root and never added to the asset library, so Glide never processes them. Saved images list their references in History, and Reuse prompt and saved prompts bring back the ones from the library.
• darkroom:smoke takes --reference= to send reference images, and shows the input image tokens Google billed.
• darkroom:prune also removes reference images older than the retention period, as opening the page does.

Changed

• Estimates and Spend now include images sent with the prompt, which Google bills at a flat rate per image: reference images, and the image being upscaled or revised. That is $0.0011 per image on Nano Banana Pro, about $0.00056 on Nano Banana 2 and about $0.00028 on Lite.

Added

• Revise. Pin numbered notes to spots on an image ("remove this door", "add a cityscape here"), add a message for the whole image, and send it back to the model for a new version. Available on unsaved images and in History. The original is left alone.
• Revision threads. The Revise panel stays open and shows every round with its notes and the image that came back. Revise from any round to go back and try again. The working area shows one card per thread, with Revisions (n) to reopen it. A saved round keeps the line of rounds that made it, so History can bring the feed back.
• Rounds remember each other. The model sees the earlier rounds, so a note can say "undo that". This keeps revision rounds on Google's side for up to 55 days; set DARKROOM_REVISION_MEMORY=false to keep nothing there. New images and upscales are never kept.
• Revision history. Saving a revised image also saves the original and every round that led to it, at full size, in a revisions folder beside it. Clicking a revised image in History shows how it was made, newest first: each image with the notes that produced it, pinned on the image they were written on, down to the original. From there, open it in the asset editor, carry on revising, or delete its revision history. Deleting the image deletes its earlier steps too, unless another image's story or a page still uses them. Set DARKROOM_SAVE_REVISION_HISTORY=false to keep none of them.

Changed

• Unsaved rounds of a revision thread are kept until 24 hours after the thread's latest round, so a long session cannot lose its first rounds before the last is saved.

Fixed

• A saved round that was moved or renamed no longer drops out of its thread.
• Revising the original again from the Revise panel stays in the same thread instead of starting a new one the panel never showed.
• An image saved straight after Create Folder in the save picker now goes into that folder, not beside it.

Security

• The README now explains that Statamic's .meta files, which hold prompts and revision notes, can be served publicly, and how to block them.

Changed

• The README no longer has a Testing section. Running the test suite is only needed to work on Darkroom itself.
• The README lists the requirement as Statamic 6 rather than a point release. Composer still enforces the exact version.

First release.

Added

• Generate images from the Control Panel with Nano Banana Pro, Nano Banana 2 or Nano Banana 2 Lite, using your own Google API key.
• Google's description of the chosen model is shown below the Model menu.
• Choose aspect ratio (Auto plus ten ratios), quality (1K, 2K, 4K, plus 0.5K on Nano Banana 2), file type (JPEG, WebP or PNG) and a batch size of 1 to 4.
• Estimated cost shown before generating.
• Preview each image, then save it with a filename and alt text into a folder chosen in Statamic's own asset browser, where folders can also be created. Or discard it.
• Filenames are slugified as they are typed or pasted.
• Images are saved at full size, through Statamic's normal upload path.
• Write alt text for an image with one click, using a Gemini text model on the same API key.
• Upscale any unsaved or saved image to a larger size, on any model, with the pixel size and price of each option shown.
• Reusable system instructions, with an optional default.
• Saved prompts that remember their settings.
• History tab listing every saved image, searchable by prompt, filename, alt text or system instruction, and paged like the Assets listing. Click an image to edit the asset in Statamic's own editor without leaving Darkroom, or reuse its prompt and settings, or upscale it.
• Trash. Tick images in History and move them to Trash, where they stay in the asset library and keep working until they are deleted after 30 days. Restore them, or delete them forever from the Trash tab, which appears only while it has anything in it. Darkroom checks whether an image is used on the site first, offers to keep it in the asset library instead, and never deletes a used image automatically.
• Spend tab with an estimated total per month, by model, and an itemised list. Each user sees their own images; the See everyone's spend in Darkroom permission shows everyone's.
• Generation and saving run after the response, so no queue worker is needed.
• An expired session says to reload and log in again.
• darkroom:smoke and darkroom:prune commands.
• Uninstall instructions in the README, including what Darkroom leaves behind.