Files on disk
A project folder
A project is any folder containing a project.fdraw. Nothing else marks one,
nothing registers it anywhere, and moving the folder moves the project.
fluffy cloud/
project.fdraw the drawing
exports/
2026-08-21_144312_fluffy_cloud.glb an archive, never overwritten
2026-08-21_144312_fluffy_cloud.meshes.json
2026-08-21_150102_fluffy_cloud.svg
latest/
fluffy_cloud.glb the copy your game loads
fluffy_cloud.meshes.json
project.fdraw is JSON: the canvas size, the layers as embedded PNGs, the
per-layer depth and Z offset, the side-wall shade, the pivot, the scale, the
mirror axes, and the palette’s colours.
The palette’s colours travel with the project, not a reference to a palette. A project has to open with its right colours on a machine that has never seen your library. Everything else it merely references.
Every export is written twice — a timestamped archive that is never replaced,
and a fixed-name copy in latest/ for a path your game can hard-code. See
Exporting.
What an export writes
| Suffix | What it is |
|---|---|
.glb | the mesh, an embedded PNG atlas, and a node hierarchy of sprite → layer → island |
.meshes.json | the sidecar: index → island, plus the pivot, the scale, which way the layers run, and the bounds |
.bbmodel | the model as a Blockbench project — quads, a group per layer, the texture inside |
.obj · .mtl · .atlas.png | the model as Wavefront OBJ, its material file, and the texture the material names — three files that only work together |
.stl | the model as one closed solid for printing, at a millimetre per pixel |
.png | the artwork, composited flat, at its own pixel size |
.vector.png | the line art, rasterised |
.view.png | the 3D view, model only, no ground |
.svg | the line art as a vector file |
Four of those are PNGs of the same project, told apart by suffix alone. That is
deliberate and worth knowing before you write a script that globs *.png.
What is in a .glb
Standard binary glTF, loadable by anything that reads glTF 2.0.
- One mesh per island — a separately connected piece of artwork — grouped under a node per layer.
- One material, one embedded PNG atlas,
NEARESTsampling requested. The atlas is never taller than it is wide, and a power of two when the canvas is one. alphaMode: "BLEND"only when some texel in the atlas is translucent; otherwise the key is absent and the model behaves as an opaque one.KHR_materials_unliton the material when Unlit material is on — listed as used, never as required, so a loader that does not know it still opens the file.- The pivot is baked into the geometry, so
DrawModel(m, pos, …)needs no offset.
The .meshes.json sidecar
{
"generator": "Flatty",
"model": "fluffy_cloud.glb",
"canvas": { "w": 32, "h": 32 },
"pixelsPerUnit": 16,
"pivot": "bottom-center",
"orientation": "back-to-front",
"bounds": { "min": [-1, 0, -0.25], "max": [1, 2, 0.25] },
"meshes": [
{ "index": 0, "name": "part_1", "layer": "face", "path": "face/part_1",
"layerIndex": 0, "cells": 210, "bounds": { "min": [], "max": [] } }
]
}
It exists because raylib’s Model has no mesh names, only a Meshes array. Look
parts up by path rather than by bare name: island names are numbered per
layer, so two layers can each hold a part_1.
orientation is back-to-front or bottom-to-top — which way the layers were
read into the model. The geometry and the bounds are already turned, so it
changes nothing a game has to do; it is there so a script can tell which axis
the layer stack runs along without measuring.
Your settings and your libraries
| Platform | Settings folder |
|---|---|
| Linux | ~/.config/flatty/ |
| macOS | ~/Library/Application Support/flatty/ |
| Windows | %AppData%\flatty\ |
flatty/
config.json recent projects, workspaces, preferences, your keymap
palettes/ one .json per palette
media/ one .png per picture, plus a .meta.json beside it
themes/ one .json per theme you made or imported
layouts/ one .json per saved layout
Everything is written atomically, so an interrupted write cannot leave a truncated file.
config.json stores only what you changed. Your keymap is a list of
deviations from the shipped one, which is what lets a later version move a
default without overriding your choice — and what makes a shortcut you cleared on
purpose stay cleared.
There is a second folder, in your system’s cache directory, for what Flatty can rebuild by itself: the list of fonts on your machine, and the media gallery’s thumbnails. Deleting it costs nothing but the seconds it takes to fill in again.
Your projects are somewhere else entirely — wherever you put them.
Palette files it reads and writes
Reads: .gpl (GIMP), .pal, .hex, .txt, and .ase (Aseprite).
Writes: .gpl, .pal, .hex, .txt.
Image formats
| opens | PNG, JPEG, GIF |
| the media library stores | PNG only |
| exports | PNG |
WebP and AVIF are not offered, because Go has no decoder for either in its standard library.
A source over 40 megapixels is refused, read from the file’s header. Anything smaller opens, and the result is capped instead — 512 px on the long edge for a brush texture, the canvas’s own long edge for a picture going onto it.