commit efc6a44051eb0949569b527885847cca2e77e22f
Author: Nikita Tsymbal <nikita.tsym@gmail.com>
Date:   Fri Mar 27 07:48:29 2026 +0000

    Add Spintoon quick start guides (EN + RU)

diff --git a/docs/spintoon/GUIDE.md b/docs/spintoon/GUIDE.md
new file mode 100644
index 0000000..1a30f6c
--- /dev/null
+++ b/docs/spintoon/GUIDE.md
@@ -0,0 +1,39 @@
+# Spintoon — Quick Start
+
+Spintoon lets you draw animations by controlling time while you draw.
+
+## Drawing
+
+Just draw — by default **AutoFlow** is on, so time advances automatically while your pen is down. Lift the pen and time stops. The speed shown on the wheel (e.g. 1.0x) controls how fast time flows.
+
+## Time Wheel
+
+The circle on the left is your time position. Touch it to pause playback and scrub time manually — drag up to go forward, down to go back. The closer to the center you grab, the faster it moves.
+
+## Controls Around the Wheel
+
+Buttons are arranged like a clock: **Play/Pause** at 3 o'clock starts animation playback. **AutoFlow** at 4 o'clock toggles automatic time flow while drawing. **Speed** buttons at 1 and 2 adjust playback/drawing speed. **Undo/Redo** at 9 and 10. **Rewind** at 11:30 jumps to the start. **Resize** at 5:30 and 6:30 changes wheel size. **Move** at 8 lets you drag the wheel to a comfortable spot.
+
+## Tools Panel (Right Side)
+
+The vertical panel on the right has your drawing tools. **Pencil** is the default draw tool. **Clock** is Time Shift — tap a stroke then drag up/down to move it earlier or later in the animation. Below the tools: brush size buttons, color palette (drag your finger across to pick), and a preview circle showing current brush.
+
+## Presets
+
+The three squares at the top of the tools panel are brush presets. **Long-press** to save your current color and size. **Tap** to instantly switch to that preset.
+
+## Color Picker
+
+Touch anywhere in the color grid and drag — a preview bubble follows your finger showing the color at your current brush size. Release to select.
+
+## File Menu
+
+Tap the Spintoon logo in the top-left corner. **New** creates a blank project. **Open** loads a .spintoon file. **Save** exports your project with all stroke data. **Export GIF** renders the animation. **Export Process** creates a timelapse of your drawing process followed by the final animation.
+
+## Touch Drawing
+
+The finger icon in the top-right toggles whether touch input draws. Turn it off when you want to use fingers only for the time wheel.
+
+## Tips
+
+You can draw during playback — strokes land on whatever frame is currently showing. Use Play + drawing for loop-style animation. The wheel and tools panel can both be repositioned by activating their move buttons.
diff --git a/docs/spintoon/GUIDE_RU.md b/docs/spintoon/GUIDE_RU.md
new file mode 100644
index 0000000..7f41913
--- /dev/null
+++ b/docs/spintoon/GUIDE_RU.md
@@ -0,0 +1,39 @@
+# Spintoon — Быстрый старт
+
+Spintoon позволяет рисовать анимацию, управляя временем прямо во время рисования.
+
+## Рисование
+
+Просто рисуй — по умолчанию включён **AutoFlow**, время идёт вперёд пока перо касается экрана. Поднял перо — время остановилось. Скорость отображается на колесе (например 1.0x).
+
+## Колесо времени
+
+Круг слева показывает текущую позицию на таймлайне. Коснись его чтобы поставить на паузу и перемотать вручную — тяни вверх вперёд, вниз назад. Чем ближе к центру берёшь, тем быстрее мотает.
+
+## Кнопки вокруг колеса
+
+Расположены как на часах: **Play/Pause** на 3 часа — воспроизведение анимации. **AutoFlow** на 4 часа — включает автоматический ход времени при рисовании. **Скорость** на 1 и 2 часа — замедление и ускорение. **Undo/Redo** на 9 и 10 часов. **Перемотка** на 11:30 — в начало. **Размер колеса** на 5:30 и 6:30. **Перемещение** на 8 часов — позволяет перетащить колесо в удобное место.
+
+## Панель инструментов (справа)
+
+Вертикальная панель справа. **Карандаш** — рисование (по умолчанию). **Часы** — сдвиг во времени: тапни на штрих и тяни вверх/вниз чтобы сдвинуть его раньше или позже на таймлайне. Ниже: размер кисти, палитра цветов (тяни пальцем для выбора), превью текущей кисти.
+
+## Пресеты
+
+Три квадрата вверху панели — пресеты кисти. **Долгое нажатие** сохраняет текущий цвет и размер. **Тап** мгновенно переключает на этот пресет.
+
+## Выбор цвета
+
+Коснись любого места в палитре и тяни — превью-кружок летает рядом с пальцем, показывая выбранный цвет в текущем размере кисти. Отпусти чтобы выбрать.
+
+## Меню файла
+
+Тапни на логотип Spintoon в левом верхнем углу. **New** — новый проект. **Open** — открыть файл .spintoon. **Save** — сохранить проект со всеми штрихами. **Export GIF** — рендер анимации. **Export Process** — таймлапс процесса рисования + финальная анимация.
+
+## Рисование пальцем
+
+Иконка пальца в правом верхнем углу включает/выключает рисование тачем. Выключи когда хочешь использовать пальцы только для колеса времени.
+
+## Советы
+
+Можно рисовать во время воспроизведения — штрихи ложатся на текущий кадр. Play + рисование = анимация в цикле. Колесо и панель инструментов можно перетащить в удобное место через кнопки перемещения.