Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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

SuffixWhat it is
.glbthe mesh, an embedded PNG atlas, and a node hierarchy of sprite → layer → island
.meshes.jsonthe sidecar: index → island, plus the pivot, the scale, which way the layers run, and the bounds
.bbmodelthe model as a Blockbench project — quads, a group per layer, the texture inside
.obj · .mtl · .atlas.pngthe model as Wavefront OBJ, its material file, and the texture the material names — three files that only work together
.stlthe model as one closed solid for printing, at a millimetre per pixel
.pngthe artwork, composited flat, at its own pixel size
.vector.pngthe line art, rasterised
.view.pngthe 3D view, model only, no ground
.svgthe 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, NEAREST sampling 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_unlit on 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

PlatformSettings 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

opensPNG, JPEG, GIF
the media library storesPNG only
exportsPNG

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.