Key Design Goals

• Editor-only , zero runtime footprint; the entire tool lives behind #if UNITY_EDITOR.
• ScriptableObject project , all sprite data is stored in a SpriteProject asset, enabling standard Unity version control and undo integration.
• Layer-frame architecture , layers are project-global definitions; each frame stores pixel data keyed by layer ID. Every frame always holds data for all project layers.
• Full undo integration , all mutations go through Undo.RecordObject on the project asset, integrating with Unity's Edit menu (Ctrl+Z, Ctrl+Shift+Z).
• Service container pattern , subsystems are resolved through a ServiceContainer for dependency injection and testability.
• Comprehensive test coverage , 26 editor test files covering data models, controllers, tools, export, and integration scenarios.

Access

Open via Tools/A2K/Sprite Maker or the keyboard shortcut Ctrl+Shift+M (configurable in settings).

System Limits

Architecture

The window is implemented as a partial class split across eight files for maintainability.

Window Partial Files

Core Systems

Controllers

Service Interfaces

Platform Clipboard Providers

ClipboardFactory selects the correct provider at runtime based on Application.platform.

Project Data Model

A SpriteProject is a ScriptableObject created via Assets → Create → A2K → Sprite Project.

SpriteProject Fields

LayerDefinition Fields

Blend Modes

SpriteFrame Fields

Pixel data for each layer is stored per frame and accessed via the layer's Id.

AnimationData Fields

Loop Modes

Canvas

Navigation

Zoom range: 0.25× – 64×. Zoom step multiplier: ×1.15 per scroll tick.

Overlays

Symmetry Modes

Symmetry is a project-level constraint. When active, all drawing tools mirror strokes across the configured axes automatically.

Onion Skin

Previous frames are tinted red; future frames are tinted blue. Opacity decreases by 25% per frame from the current position. Configurable settings: enabled toggle, frame count (how many frames before/after to show), opacity value. Stored in EditorPrefs via SpriteMakerSettings.

Canvas Resize

Canvas resize uses an AnchorPoint to determine where existing pixels are positioned in the new bounds.

Tools

The ToolManager registers all tools at construction and routes input events to the active tool through a shared ToolContext.

Tool List

Brush Settings

All drawing tools share a single BrushSettings instance through ToolContext.

Brush size is adjusted with [ (decrease) and ] (increase), or - and =.

Hardness falloff: pixels within the hard core radius receive full opacity. Pixels in the soft region receive quadratic falloff: opacity × max(0, 1 - t²) where t is the normalized distance from the hard core edge to the brush boundary.

Shape Fill Modes

Applies to Rectangle and Ellipse tools. Toggle with F while a shape tool is active.

Clone Stamp

The Clone Stamp tool operates in three sub-modes selected via keyboard shortcuts.

Aligned mode: when enabled, the offset between source and destination is preserved as you paint. When disabled, painting always samples from the original source point.

Content-Aware Fill

Content-Aware Fill fills a selection by sampling the surrounding pixel edges. Up to 20 independent generations can be produced from a single selection; cycle through them to find the best result.

• Requires an active selection.
• Collects edge pixel colors from the selection boundary.
• Generates up to 20 variants from different random seeds.
• Each generation is stored; navigate with cycle controls without redrawing.
• Accessible from the right-click context menu when a selection is active.

Selection Operations

When a selection is active the following operations are available.

Selection mode modifiers: hold Shift while using Selection or Magic Wand to add to the current selection. Hold Ctrl to subtract.

Layers

Layers are project-global. Every frame in the project holds pixel data for every layer. Adding or removing a layer updates all frames simultaneously.

Layer Operations

Layer Compositing

Frames are composited top-to-bottom through the layer stack. Each layer applies its BlendMode at its Opacity over the accumulated result below it. Invisible layers are skipped. The composite result is what is displayed on the canvas and what is rendered to the export texture.

Timeline and Animations

Animations

A project can contain multiple named animations. Each animation references an ordered list of frame IDs. The active animation determines which frames appear in the timeline.

Frame Operations

Multi-Frame Selection

Hold Shift or Ctrl in the timeline to select multiple frames. Delete and duplicate apply to the entire selection.

Palette

The palette stores up to 256 Color32 entries. Index 0 is always transparent and cannot be removed or made opaque — this invariant is enforced on every setter.

Palette Operations

Palette Ramps

Palettes support up to 64 named PaletteRamp entries. Ramps group palette indices into ordered tonal sequences for structured color workflows. Each ramp stores a name and an ordered list of palette color indices.

Indexed Color Mode

Layers with UseIndexedColor enabled constrain drawing to the project palette. Drawing with a color not in the palette finds the nearest palette entry instead of writing an arbitrary color.

Export System

The export system is driven by an ExportProfile and orchestrated by ExportPipeline. Pre-export validation runs through ExportValidator before any file is written.

Export Modes

Export Content

Output Formats

Atlas Layout Modes

Size Policies

Packing Sort Modes

Atlas Settings

Individual Sprite Settings

Applies when ExportMode is IndividualSprites.

Overflow modes:

Sprite Settings

Pivot Modes

Unity Asset Generation

Unity Import Settings

Applied to the exported texture via TextureImporter after writing.

Naming Schemes

File names are resolved by NamingResolver using token substitution.

Available tokens in custom patterns: {animation}, {frame:00} (zero-padded frame number), {project}.

Metadata Export

When ExportMetadata is enabled, a JSON file is written alongside the sprite texture containing animation names, frame counts, frame rates, loop modes, and sprite rect data.

Per-Sprite Adjustments

SpriteAdjustmentCollection allows per-frame overrides in IndividualSprites mode. Each SpriteAdjustment is identified by animation name and frame index and supports:

• Exclusion — exclude this specific frame from export
• Bounds override — specify a custom crop rect instead of auto-detecting content bounds
• Offset — apply X/Y offset when placing the sprite in the output
• Pivot override — per-sprite custom pivot point
• Name override — custom file name for this specific sprite

Export Window

The Export Window (ExportWindow) is a separate EditorWindow with a WYSIWYG atlas preview. Open via the Export button in the main Sprite Maker window.

Preview Panel

The preview shows a real-time render of the packed atlas at the current profile settings.

• Pan with middle mouse or Alt+left drag
• Zoom with scroll wheel
• Toggle sprite rect overlays (shows each sprite's bounds)
• Toggle animation color bands (color-coded regions per animation, 8 distinct colors cycling)
• Click a sprite rect to select it and view its detail

Detail View

When a sprite is selected in the preview, a detail panel shows a zoomed view of that sprite with:

• Zoom and pan within the detail panel
• Content bounds overlay (red) — auto-detected non-transparent pixels
• Output bounds overlay (green) — final export bounds after trim/pad operations
• Interactive bounds editing for per-sprite adjustment overrides

Warning Panel

Pre-export warnings appear in a scrollable list above the export button. Warnings are non-blocking; errors prevent export.

Export Profile Persistence

The ExportProfile is serialized on the ExportWindow instance as a [SerializeField], persisting through domain reloads. The project is referenced via its asset path string.

Clipboard

Clipboard operations use the system clipboard as the single source of truth. Internal copy writes to the system clipboard; paste reads from it. This allows copy-paste between the Sprite Maker and external applications such as Photoshop or Aseprite.

Operations

Windows Implementation

On Windows, ImageClipboard reads CF_DIB (24-bit) and CF_DIBV5 (32-bit with alpha) clipboard formats via P/Invoke. Writing uses CF_DIBV5 to preserve the alpha channel. Row alignment is 4-byte boundary. Maximum image dimension: 8192 px.

Import

Textures can be imported from the Project window into the Sprite Maker via drag-and-drop onto the canvas. The imported texture is placed as a new frame or onto the current canvas depending on context.

Keyboard Reference

Tools

Canvas

Editing

Clone Stamp

Test Coverage

The test suite lives in Tests/Editor/ and uses A2K.SpriteMaker.Tests.asmdef. All tests run in the Unity Test Runner under the Editor category.

Installation

Drop these four files into any Editor folder:

Assets/Editor/QuickNotes/
├── Quicknotes_UIToolkit.cs
├── Quicknotes_UIToolkit.uxml
├── Quicknotes_UIToolkit.uss
└── Quicknotes_NoteCard.uxml

Recompile, then open via the menu above. The window docks like any Unity panel.

Interface

┌─────────────────────────────────────────────────────────────────┐
│  [🎨] [☆] [▼ Category]      [🔍 Search...]      [+ Quick Add]  │
├──────────────────────┬──────────────────────────────────────────┤
│  ┌────────────────┐  │  [Icon] [● ● ● ● ● ● ● ●] [🎨] [★] [⋮] │
│  │ 📝 Note Title  │  ├──────────────────────────────────────────┤
│  │ Preview...     │  │  Title                                   │
│  │ Category  2h   │  │                                          │
│  └────────────────┘  │  Content area                            │
│  ┌────────────────┐  │                                          │
│  │ 💡 Another     │  │  Category ▼   Tags [+]   Attachments     │
│  └────────────────┘  │                                          │
├──────────────────────┴──────────────────────────────────────────┤
│  12 notes                                  Archived  ⋮          │
└─────────────────────────────────────────────────────────────────┘

Notes

Creating — Click + in the list header, press Ctrl+N, or type in the quick-add field and press Enter. Quick-add inherits the active category filter.

Editing — Click a note to open it. Title, content, icon, color, and category all save automatically on change. The icon button cycles through 27 emoji options; the color row shows 12 presets.

Deleting — Trash icon in the editor toolbar, or right-click → Delete. Supports Ctrl+Z.

Organizing

Categories group notes at a coarse level. Filter by category using the header dropdown. Manage them via the ⋮ menu → Manage Categories. Renaming a category updates every note using it.

Tags cross-reference across categories. Add them in the Tags section of the editor; the search field matches tag content alongside title and body text.

Pinned notes stay at the top of the list regardless of sort. Toggle pin with ★ in the editor toolbar. The ★ button in the header filters to pinned notes only.

Archived notes are hidden by default. Check Archived in the footer to show them. Archive instead of deleting anything you might want later.

Attachments

Drag any asset from the Project window onto the attachments area. Click an attachment to ping it in Project; × removes the link without deleting the file.

Themes & Styling

Each note has its own style mode, set in the Style Sidebar (🎨 in the editor toolbar):

Applying a theme — Open the Style Sidebar, switch to Theme mode, pick from the dropdown.

Theme Manager — Click 🎨 in the list header. Create, duplicate, edit, or delete custom themes. Built-in themes are read-only.

Built-in themes:

Custom styling — In the Style Sidebar, select Custom mode and adjust individual properties. Save as Theme to reuse on other notes.

Theme properties:

Multi-Select

When notes are selected, a toolbar appears above the list: Pin, Archive, Delete. Right-clicking any selected note shows the same options as a context menu.

Import & Export

Notes — ⋮ menu → Export Notes / Import Notes. Export writes all notes as JSON. Import offers Merge (adds to existing) or Replace (clears first).

Data files — stored in ProjectSettings/, saved on every change, safe to version-control.

Shortcuts

Architecture

Three files, one job each:

No inline styles in UXML. No hardcoded colors in code. No business logic in markup.

Style resolution order (later overrides earlier):

1. USS base
2. Theme — if note.Style.ThemeId is set
3. Custom — if note.UseCustomStyle is true
4. State — active/selected overrides background

Performance notes — ListView is virtualized; only visible cards render. UI elements are cached on CreateGUI, not re-queried per frame. CSS variables mean theme changes update the whole window in one pass.

Undo — Every destructive action serializes NotesData to a ScriptableObject buffer via Undo.RecordObject. Standard Ctrl+Z works across all operations.

API Reference

Namespace:A2K.Editor.Tools.Quicknotes.UIToolkit

Note

string Id, Title, Content, ColorHex, IconId, Category, LinkedTaskId, Created, Modified;
int ColorIndex;          // 0–11 preset, -1 custom
List<string> Tags;
List<Attachment> Attachments;
bool Pinned, Archived, UseCustomStyle;
int SortOrder;
NoteStyle Style;

NoteStyle

string ThemeId, AccentHex, CardBgHex, TitleColorHex, ContentBgHex, ContentColorHex;
int TitleSize, ContentSize, AccentWidth, Padding;
bool TitleBold, TitleItalic;
void Clear();

NoteTheme — same color/font properties as NoteStyle, plus:

string Id, Name, Description, Author, Created;
bool IsBuiltIn;
NoteTheme DeepCopy();

Attachment

string Name, Path, GUID, Type;

Icons (27):

note 📝 · idea 💡 · star ⭐ · bookmark 🔖 · flag 🚩 · bug 🐛 · fix 🔧 · code 💻 · gear ⚙ · rocket 🚀 · question ❓ · check ✅ · warning ⚠ · error ❌ · clock 🕐 · link 🔗 · file 📄 · folder 📁 · image 🖼 · audio 🔊 · chat 💬 · email 📧 · user 👤 · team 👥 · high 🔴 · medium 🟡 · low 🟢

Preset colors: Yellow · Orange · Red · Pink · Purple · Indigo · Cyan · Teal · Green · Lime · Gray · White (indices 0–11)

Adding an icon:

// Append to the ICONS array
new("custom", "🎮", "Gaming")

Adding a built-in theme:

new NoteTheme { Id = "builtin_custom", Name = "My Theme", IsBuiltIn = true, AccentHex = "#..." }

Adding a panel view:

1. UXML — add the view container
2. PanelMode enum — add the value
3. QueryElements() — cache the element
4. RefreshContentPanel() — handle visibility
5. Write a Refresh___View() method

Troubleshooting

Window won't open — Check the Console for compile errors. All four files must be in an Editor folder.

Styles not applying — USS must be in the same folder as UXML. Element name attributes in UXML must match C# queries exactly.

Notes not saving — ProjectSettings/ must exist and be writable.

Import failing — File must be valid JSON exported by Quick Notes. Special characters in note content can corrupt JSON if the file was edited externally.

A2K · 2025

A2K Quick Notes — IMGUI

Tools → A2K - Documentation → A2K Quick Notes

Unity 2021.3+ · Minimum window size 750 × 500 px

A note-taking window for the Unity Editor built entirely with IMGUI — one .cs file, no external assets required.

Installation

Drop the single file into any Editor folder:

Assets/Editor/QuickNotes/
└── Quicknotes.cs

That's it. No UXML, no USS, no additional setup.

Interface

┌────────────────────────────────────────────────────────────────────┐
│  A2K Quick Notes                               [🎨]  [★]  [+]     │
│  [🔍 Search.................] [▼ Category]                         │
│  [Quick Add.........................] [Add]                         │
├─────────────────────┬──────────────────────────────────────────────┤
│  ★ PINNED           │  [Icon] [● ● ● ● ● ● ● ●] [🎨] [★] [⋮]    │
│  ┌─────────────────┐│  ────────────────────────────────────────   │
│  │ ≡ 📝 Title      ││  Title                                      │
│  │ Preview...      ││                                             │
│  │ Category  2h    ││  Content area                               │
│  └─────────────────┘│                                             │
│                     │  ▼ Tags  ▼ Attachments                      │
│  ALL NOTES          │                      ┌────────────────────┐ │
│  ┌─────────────────┐│                      │ Style sidebar      │ │
│  │ ≡ 💡 Title      ││                      └────────────────────┘ │
│  └─────────────────┘│                                             │
│  2 notes  Archived ⋮│                                             │
└─────────────────────┴──────────────────────────────────────────────┘

The left and right panels are split by a draggable divider. Drag it horizontally; the ratio is saved between sessions. The split is clamped between 22% and 42% of the window width.

Notes

Creating — Click + in the list header, or type in the quick-add field and press Enter or click Add. Quick-add inherits the active category filter.

Editing — Click a note to open it. Everything saves automatically. The icon button opens a picker with 27 options; the color row shows 12 presets. Click 🎨 in the toolbar to open the style sidebar.

Note cards show the drag handle (≡), icon, title (truncated at 24 chars), a content preview (50 chars), category, and modified timestamp. Status badges appear when relevant: ★ pinned · 🏷 has tags · ◎ has attachments · ◆ has custom style. Selection checkboxes appear whenever any notes are selected.

Search highlighting — Matching text in the title and content preview is highlighted in yellow directly on the card, in real time.

Deleting — Right-click → Delete, or select notes and press Delete. Supports Ctrl+Z.

Organizing

Categories group notes at a coarse level. Filter using the dropdown in the toolbar. Manage via the ⋮ footer menu → Manage Categories. Renaming a category updates every note using it; all changes are undoable.

Tags cross-reference across categories. Expand the Tags section in the editor to add or remove them. Search matches tag content.

Pinned notes live in a dedicated ★ PINNED section above all other notes. Toggle via the ★/☆ button in the editor toolbar, or right-click a card → Pin. The ★ button in the header filters to pinned only.

Archived notes are hidden by default. Toggle Archived in the footer to show them. Archiving is reversible; deleting requires confirmation.

Attachments

Drag any asset from the Project window onto the attachments section of an open note. The window listens to Selection.selectionChanged, so it refreshes whenever your Project selection changes.

Click an attachment to ping it in Project. × removes the link without touching the file.

Themes & Styling

Each note has its own style mode, set in the Style Sidebar (🎨 in the editor toolbar):

Applying a theme — Open the Style Sidebar, switch to Theme mode, pick from the dropdown.

Theme Manager — Click 🎨 in the list header. Browse built-in and custom themes, create new ones, duplicate as a starting point, or edit with a live preview. Custom themes can be deleted; built-in ones cannot.

Built-in themes (8, read-only):

Custom styling — Select Custom mode and adjust properties. Click Save as Theme to reuse; click Reset to revert to theme defaults (asks for confirmation).

Theme properties:

Multi-Select

When notes are selected, a blue toolbar appears above the list:

Right-clicking any selected note shows the same options as a context menu.

Import & Export

Notes — ⋮ footer menu → Export Notes / Import Notes. Export writes all notes as JSON. Import offers Merge (adds to existing) or Replace (clears first).

Themes — Theme Manager → Export Themes / Import Themes. Only custom themes export; built-ins are excluded. Imported themes get new IDs to prevent conflicts.

Data files:

All files live in ProjectSettings/, save on every change, and can be version-controlled.

Shortcuts

Ctrl+N, Ctrl+S, and Ctrl+A are defined but commented out in HandleKeyboardShortcuts(). Uncomment the relevant case blocks to enable them.

Architecture

Everything runs from Quicknotes.cs. The file is organized into #region blocks:

Panel system — The right panel routes through four modes:

NoteEditor       default view
ThemeManager     browse and manage themes
ThemeEditor      create or edit one theme
CategoryManager  manage categories

Clicking 🎨 in the list header toggles between ThemeManager and NoteEditor.

Undo — RecordUndo(label) serializes the full NotesData to a ScriptableObject buffer before any destructive change. Standard Ctrl+Z works for everything.

Performance — Filtered note lists are populated once per frame into cached List fields and reused across card drawing, avoiding per-card LINQ. Category and theme dropdown arrays rebuild only when their _dirty flag is set. All string concatenation in hot paths goes through a shared StringBuilder. Background textures are created once and explicitly destroyed in OnDisable/OnDestroy. wantsMouseMove = true enables hover effects without extra repaint calls.

API Reference

Namespace:A2K.Editor.Tools.Quicknotes

Note

string Id, Title, Content, ColorHex, IconId, Category, LinkedTaskId, Created, Modified;
int ColorIndex;       // 0–11 preset, -1 custom
List<string> Tags;
List<Attachment> Attachments;
bool Pinned, Archived, UseCustomStyle;
int SortOrder;
NoteStyle Style;

NoteStyle

string ThemeId, AccentHex, CardBgHex, TitleColorHex, ContentBgHex, ContentColorHex;
int TitleSize, ContentSize, AccentWidth, Padding;
bool TitleBold, TitleItalic, ContentBold, ContentItalic;
void Clear();
void CopyFrom(NoteStyle other);

NoteTheme — same color/font properties as NoteStyle, plus:

string Id, Name, Description, Author, Created;
bool IsBuiltIn;
NoteTheme DeepCopy();
void CopyFrom(NoteTheme other);

Attachment

string Name, Path, GUID, Type;

Icons (27):

note 📝 · idea 💡 · star ⭐ · bookmark 🔖 · flag 🚩 · bug 🐛 · fix 🔧 · code 💻 · gear ⚙️ · rocket 🚀 · question ❓ · check ✅ · warning ⚠️ · error ❌ · clock 🕐 · link 🔗 · file 📄 · folder 📁 · image 🖼️ · audio 🔊 · chat 💬 · email 📧 · user 👤 · team 👥 · high 🔴 · medium 🟡 · low 🟢

Preset colors: Yellow · Orange · Red · Pink · Purple · Indigo · Cyan · Teal · Green · Lime · Gray · White (indices 0–11)

Adding an icon:

new("custom", "🎮", "Gaming")  // append to ICONS array

Adding a built-in theme:

// In EnsureBuiltInThemes(), add a CreateBuiltIn call:
// CreateBuiltIn(name, description, accent, cardBg, titleColor, contentBg, contentColor)
CreateBuiltIn("Midnight", "Deep dark", "#7C4DFF", "#0D0D14", "#E8E8FF", "#07070F", "#AAAACC")

Troubleshooting

Window won't open — Check the Console for compile errors. The file must be inside an Editor folder.

Notes not saving — ProjectSettings/ must exist with write permissions.

Undo not working — Only actions performed through the window are tracked. External edits to the JSON files are not.

Themes missing after import — Imported themes receive new IDs automatically. If a theme appears to be missing, check for a duplicate with a slightly different name.

Split panel too narrow — Drag the divider, or clear A2K_QuickNotes_SplitRatio from EditorPrefs to reset to the default 30%.

Textures look wrong after recompile — Close and reopen the window. Textures are rebuilt in OnEnable.

A2K · 2025

A2K Task Manager — IMGUI

Tools → A2K - Documentation → A2K Task Manager

Unity 2021.3+ · Minimum window size 900 × 500 px

A Kanban board for the Unity Editor with GitHub Issues integration. Tracks tasks offline, pulls issues from GitHub without a personal access token, and scans scripts for TODO comments automatically.

Installation

Drop the single file into any Editor folder:

Assets/Editor/TaskManager/
└── TaskManager.cs

No additional files required.

Interface

┌─────────────────────────────────────────────────────────────────────────┐
│  [📋 Local] [⎇ GitHub]  🔍[Search] Category▼ Assignee▼ Priority▼ Done  │
│                         [🔍 Scan TODOs]  [+ New Task]             [⚙]  │
├────────────────┬────────────────┬────────────────┬──────────┬───────────┤
│ ⚪ Todo (3)   │ 🔵 In Progress │ 🟠 Review (1) │🟢 Done  │🔴 Blocked │
│ [+]           │ [+]            │ [+]            │ [+]      │ [+]       │
│ ┌────────────┐│ ┌────────────┐ │                │          │           │
│ │⋮⋮ 🔴      ││ │⋮⋮ #12      │ │                │          │           │
│ │Task Title  ││ │Task Title  │ │                │          │           │
│ │[Bug]       ││ │[Feature]   │ │                │          │           │
│ │👤 Alex  📅 ││ │👤 Me    📅 │ │                │          │           │
│ │☑2/4  💬1  ││ │⏱2h        │ │                │          │           │
│ │        ✏  ││ │       📄 ✏│ │                │          │           │
│ └────────────┘│ └────────────┘ │                │          │           │
├─────────────────────────────────────────────────────────────────────────┤
│  12 tasks · 3 In Progress · 2 linked to GitHub            [exported]   │
└─────────────────────────────────────────────────────────────────────────┘

Tasks

Creating — Click + New Task in the toolbar, or click + inside any column to create a task directly in that status. Both open the task editor immediately.

Task cards show, from top to bottom:

• Drag handle (⋮⋮) and priority badge (🔴 Critical · 🟠 High · 🟢 Low; Medium shows nothing)
• A left-edge color bar matching the priority
• Title (truncated at 40 characters)
• Category tag with its configured color
• Assignee and due date (red with ⚠ if overdue and not done)
• Checklist progress bar, comment count, and logged time
• Source file button (📄, opens script at the line the TODO was on), edit button (✏), and GitHub issue link (#N)

Interacting with cards:

• Single-click selects the card
• Double-click opens the task editor
• Drag the ⋮⋮ handle to move to another column (shows a preview ghost while dragging)
• Right-click for the context menu

Editing a task — Click ✏ on any card, or double-click. The editor covers the full right panel with:

Duplicating — Right-click a card → Duplicate. Creates a copy in Todo with a fresh ID and blank checklist.

Deleting — Right-click → Delete, or select multiple and use the batch context menu.

Filtering

All filters apply simultaneously. The toolbar shows the visible task count after filtering.

Multi-Select

When tasks are selected a count appears above the board. Right-clicking any selected card shows a batch context menu:

• Set Category — submenu of all configured categories + Clear
• Set Priority — Critical / High / Medium / Low
• Set Status — move all selected to any column
• Assign To — any team member, or Unassigned
• Delete — removes all selected (with confirmation)

Scan TODOs

🔍 Scan TODOs in the toolbar scans every MonoScript under Assets/ for lines matching // TODO: (case-insensitive). Each unique match creates a task with:

• Title from the comment text (truncated at 50 characters)
• Category set to Code (created automatically if it doesn't exist)
• Priority set to High if the line also contains FIXME, otherwise Medium
• Source file and line number stored for the 📄 button

Subsequent scans skip any line already in the board (matched by file path + line number), so re-scanning is safe.

GitHub Integration

Setup

Set your repository in ⚙ Settings → GitHub Integration:

owner/repo       e.g.  yourname/your-project

Optionally add a Project URL — used by the 🌐 Browser button. If left blank, clicking Browser opens the repository's /issues page.

Authentication

The tool uses Git Credential Manager — the same credentials used by GitHub Desktop or git on the command line. No personal access token or OAuth flow required. Check credential status in Settings → Credentials.

GitHub Board

Switching to the ⎇ GitHub tab fetches issues from your repository and organizes them into columns based on their labels. Default column → label mappings:

Issues with no matching label appear in the first column. Click Configure Columns in the toolbar to change mappings.

Each issue card shows number, title, assignee, labels, and creation date. You can attach local metadata to any issue without pushing anything to GitHub: notes, local priority override, local assignee override, and category tag.

Toolbar (GitHub tab)

Settings

Open with ⚙ in the top-right corner; click ◀ Back to return.

GitHub Integration — Repository, project URL, credential status.

Categories — Each category has a name and a color. The color appears as the tag background on task cards. Default categories on first run: Bug, Feature, Art, Audio.

Team Members — Your name (used by the "Mine" assignee filter and for comment authorship), plus any team members to populate the Assignee dropdowns.

Accessibility — Font size (9–16 px), minimum column width (150–300 px), Large Drop Targets, and Confirm Drag & Drop (asks before moving a card). Click Apply Changes after adjusting.

Data — Export and import as JSON. Clear Completed Tasks removes all Done tasks after confirmation. Stats line shows totals at a glance.

Data

All task data is stored in ProjectSettings/A2K_Tasks.json and saves automatically on every change. The file is project-specific and can be version-controlled.

Import offers Merge (adds tasks and any new categories/members) or Replace (overwrites everything).

API Reference

Namespace:A2K.Editor.Tools

Enums:

enum Status   { Todo, InProgress, Review, Done, Blocked }
enum Priority { Critical, High, Medium, Low }
enum ViewMode { LocalBoard, GitHub, TaskEditor, Settings }

Task

string Id, Title, Description, Category, Assignee;
string DueDate, LinkedAsset, CreatedDate, CompletedDate;
string SourceFile, GitHubIssueUrl;
int SourceLine, GitHubIssueNumber;
Status Status;
Priority Priority;
float EstimatedHours, LoggedHours;
List<string> Checklist, BlockedBy;
List<bool>   ChecklistDone;
List<Comment> Comments;

Comment

string Author, Text, Date;

Category

string Name;
Color  Color;

UserPreferences

int   FontSize;           // Default: 11
int   CardPadding;        // Default: 8
float CardWidth;          // Default: 180
float ColumnMinWidth;     // Default: 170
bool  HighContrastMode;
bool  LargeDropTargets;
bool  ShowStatusText;
bool  ConfirmDragDrop;
bool  AutoRefreshGitHub;
int   GitHubRefreshMinutes; // Default: 5

GitHubIssueMetadata — local overrides attached to a GitHub issue without pushing to the remote:

int      IssueNumber;
string   Category, Assignee, LocalNotes;
Priority LocalPriority;
bool     PriorityOverride, AssigneeOverride;

BoardData — root container:

List<Task>                 Tasks;
List<Category>             Categories;
List<string>               Members;
string                     CurrentUser;
string                     GitHubRepo, GitHubProjectUrl;
List<GitHubIssueMetadata>  GitHubMetadata;
UserPreferences            Preferences;

Troubleshooting

Window won't open — Check the Console for compile errors. File must be in an Editor folder.

Tasks not saving — ProjectSettings/ must exist and be writable.

GitHub tab shows an error — Verify the repository format (owner/repo). Check that GitHub Desktop is installed and logged in, then click Check Credentials in Settings.

Scan TODOs found nothing — Scripts must be under Assets/ and use // TODO: syntax (with the double slash). The scan ignores scripts outside Assets/.

Overdue dates not showing red — Due dates must be in yyyy-MM-dd format for comparison to work. Dates in other formats are displayed but not evaluated.

A2K · 2025

A2K Task Manager — UI Toolkit

Tools → A2K - Documentation → A2K Task Manager (UI Toolkit)

Unity 2021.3+ · Minimum window size 900 × 500 px

A Kanban board for the Unity Editor with GitHub Issues integration. Fully data-compatible with the IMGUI edition — both read and write the same A2K_Tasks.json file.

Installation

Drop these files into any Editor folder:

Assets/Editor/TaskManager/UIToolkit_TaskManager/
├── TaskManager_UIToolkit.cs
├── TaskManager_UIToolkit.uxml
├── TaskManager_UIToolkit.uss
├── TaskCard.uxml
└── GitHubCard.uxml

Assets are loaded at runtime by name, so the folder location is flexible. Recompile, then open via the menu above.

Interface

┌─────────────────────────────────────────────────────────────────────────┐
│  [📋 Local] [⎇ GitHub]  [🔍 Search] [Category▼] [Assignee▼] [Prio▼]   │
│                          [Done] [Scan TODOs] [+ New Task]         [⚙]  │
├────────────────┬────────────────┬────────────────┬──────────┬───────────┤
│ ⚪ Todo        │ 🔵 In Progress │ 🟠 Review      │🟢 Done  │🔴 Blocked │
│ ┌────────────┐ │ ┌────────────┐ │                │          │           │
│ │ 🔴 Title   │ │ │ #12 Title  │ │                │          │           │
│ │ [Bug]      │ │ │ [Feature]  │ │                │          │           │
│ │ 👤 Alex    │ │ │ 👤 Me      │ │                │          │           │
│ │ 📅 Due     │ │ │ ⏱2h        │ │                │          │           │
│ │ ☑2/4  💬1  │ │ │            │ │                │          │           │
│ └────────────┘ │ └────────────┘ │                │          │           │
├─────────────────────────────────────────────────────────────────────────┤
│  Ready ·  12 tasks  ·  repo: owner/repo                   [saved]      │
└─────────────────────────────────────────────────────────────────────────┘

Tasks

Creating — Click + New Task in the toolbar, or click + at the top of any column header to create a task in that status. Both open the task editor immediately.

Task cards show priority color on the left edge, priority badge, title, category tag, assignee, due date (red if overdue), checklist progress bar, comment count, time logged, and a GitHub issue link if one is set.

Interacting with cards:

• Single-click selects
• Double-click opens the task editor
• Drag the card to move it to another column
• Right-click for the context menu

Editing a task — Double-click a card or click the edit button. The editor panel contains:

Duplicating — Right-click → Duplicate. Copies the task to Todo with a new ID and a blank checklist.

Deleting — Right-click → Delete, or select multiple and use the batch context menu.

Filtering

All filters apply simultaneously.

Multi-Select

Right-clicking any selected card shows a batch context menu: Set Category, Set Priority, Set Status, Assign To, and Delete — all applied to every selected task at once.

Scan TODOs

Scan TODOs in the toolbar scans every MonoScript under Assets/ for lines matching // TODO: (case-insensitive). Each match creates a task with:

• Title from the comment text (capped at 50 characters)
• Category Code (created automatically if needed)
• Priority High if the line also contains FIXME, otherwise Medium
• Source file and line number for one-click navigation

Re-scanning is safe — lines already in the board are skipped.

GitHub Integration

Setup

Open ⚙ Settings → GitHub Integration and enter your repository:

owner/repo       e.g.  yourname/your-project

Optionally add a Project URL for the 🌐 Browser button. If omitted, Browser opens /issues.

Authentication

Uses Git Credential Manager — the same credentials as GitHub Desktop or the git CLI. No personal access token required. Verify status in Settings → Credentials.

GitHub Board

The GitHub tab fetches issues and organizes them into columns by label. Default mappings:

Issues without a matching label go to the first column. Click Configure Columns in the toolbar to change mappings and colors.

Each issue card shows number, title, assignee, labels, and creation date. Local metadata can be attached to any issue without pushing to GitHub: notes, priority override, assignee override, and category.

GitHub Toolbar

Settings

Click ⚙ in the top-right to open Settings; click it again to return.

GitHub Integration — Repository, project URL, credential status.

Categories — Name and color per category. Color is shown as the tag background on cards. Default categories on first run: Bug, Feature, Art, Audio.

Team Members — Your name (used for "Mine" filter and comment attribution) and other team members for Assignee dropdowns.

Accessibility — Column minimum width and Large Drop Targets toggle. Confirm Drag & Drop asks for confirmation before moving any card. Settings apply immediately.

Data — Export to and import from JSON. Clear Completed Tasks removes all Done tasks (with confirmation). A stats summary shows totals, in-progress count, and linked task count.

Data

Both editions share ProjectSettings/A2K_Tasks.json. The file saves on every change, is project-specific, and can be version-controlled.

Import offers Merge (adds tasks and new categories/members) or Replace (overwrites everything).

Architecture

Five files, three concerns:

Assets are discovered at runtime using AssetDatabase.FindAssets by name, so no GUIDs are hardcoded. If a file is missing, the window shows a clear error rather than silently failing.

View system — four named VisualElement containers (view-local, view-github, view-editor, view-settings) switch visibility via .AddToClassList("hidden") / .RemoveFromClassList("hidden"). Only one is visible at a time.

Performance — Filtered task lists use pre-allocated List caches populated without LINQ. Category and member dropdown arrays rebuild only when data changes. All allocation-heavy paths avoid new per frame.

API Reference

Namespace:A2K.Editor.Tools.UIToolkit

Enums:

enum Status   { Todo, InProgress, Review, Done, Blocked }
enum Priority { Critical, High, Medium, Low }

Task

string Id, Title, Description, Category, Assignee;
string DueDate, LinkedAsset, CreatedDate, CompletedDate;
string SourceFile, GitHubIssueUrl;
int SourceLine, GitHubIssueNumber;
Status Status;
Priority Priority;
float EstimatedHours, LoggedHours;
List<string> Checklist, BlockedBy;
List<bool>   ChecklistDone;
List<Comment> Comments;

Comment

string Author, Text, Date;

Category

string Name;
Color  Color;

UserPreferences

int   FontSize;           // Default: 11
float CardWidth;          // Default: 180
float ColumnMinWidth;     // Default: 170
bool  HighContrastMode;
bool  LargeDropTargets;
bool  ShowStatusText;
bool  ConfirmDragDrop;
bool  AutoRefreshGitHub;
int   GitHubRefreshMinutes; // Default: 5

GitHubIssueMetadata — local overrides per GitHub issue, not pushed to remote:

int      IssueNumber;
string   Category, Assignee, LocalNotes;
Priority LocalPriority;
bool     PriorityOverride, AssigneeOverride;

BoardData — root container written to JSON:

List<Task>                 Tasks;
List<Category>             Categories;
List<string>               Members;
string                     CurrentUser;
string                     GitHubRepo, GitHubProjectUrl;
List<GitHubIssueMetadata>  GitHubMetadata;
UserPreferences            Preferences;

Troubleshooting

Window won't open — Check the Console for compile errors. All five files must be in an Editor folder.

UXML or card templates not found — The loader searches by filename. If you rename any file, update the name passed to FindAsset() in the source.

Tasks not saving — ProjectSettings/ must exist and be writable.

GitHub tab shows an error — Verify the repository format (owner/repo). Ensure GitHub Desktop is installed and logged in, then click Check Credentials in Settings.

Cards not appearing after scan — Scripts must be under Assets/ and use the // TODO: pattern. Existing matches are silently skipped.