chore: update What's New text

.github/ISSUE_TEMPLATE/config.yml

@@ -1,7 +1,7 @@
 blank_issues_enabled: false
 contact_links:
   - name: Project-Documentation
-    url: https://invoke.ai/
+    url: https://invoke-ai.github.io/InvokeAI/
     about: Should be your first place to go when looking for manuals/FAQs regarding our InvokeAI Toolkit
   - name: Discord
     url: https://discord.gg/ZmtBAhwWhy

.github/workflows/deploy-docs.yml

@@ -1,141 +0,0 @@
-name: 'docs'
-
-on:
-  push:
-    branches:
-      - 'main'
-  pull_request:
-    types:
-      - 'ready_for_review'
-      - 'opened'
-      - 'synchronize'
-  workflow_dispatch:
-    inputs:
-      deploy_target:
-        description: 'Deploy target (custom = invoke.ai, ghpages = invoke-ai.github.io/InvokeAI)'
-        type: choice
-        options:
-          - custom
-          - ghpages
-        default: custom
-
-permissions:
-  contents: read
-  pull-requests: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref || github.run_id }}
-  cancel-in-progress: true
-
-jobs:
-  changes:
-    runs-on: ubuntu-latest
-    outputs:
-      docs: ${{ steps.manual.outputs.docs || steps.filter.outputs.docs }}
-    steps:
-      - name: checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: mark manual run
-        if: github.event_name == 'workflow_dispatch'
-        id: manual
-        run: echo "docs=true" >> "$GITHUB_OUTPUT"
-
-      - name: detect docs-related changes
-        if: github.event_name != 'workflow_dispatch'
-        id: filter
-        uses: dorny/paths-filter@v3
-        with:
-          filters: |
-            docs:
-              - '.github/workflows/deploy-docs.yml'
-              - 'docs/**'
-              - 'scripts/generate_docs_json.py'
-              - 'invokeai/app/**'
-              - 'invokeai/backend/**'
-              - 'pyproject.toml'
-              - 'uv.lock'
-
-  check-and-build:
-    needs: changes
-    if: |
-      github.event_name == 'workflow_dispatch' ||
-      (github.event_name == 'pull_request' &&
-        github.event.pull_request.draft == false &&
-        needs.changes.outputs.docs == 'true') ||
-      (github.event_name == 'push' && needs.changes.outputs.docs == 'true')
-    runs-on: ubuntu-22.04
-    timeout-minutes: 20
-    steps:
-      - name: checkout
-        uses: actions/checkout@v4
-
-      # Python (needed for generate-docs-data)
-      - name: setup uv
-        uses: astral-sh/setup-uv@v5
-        with:
-          version: '0.6.10'
-          enable-cache: true
-          python-version: '3.11'
-
-      - name: setup python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-
-      # generate_docs_json.py only needs the invokeai package importable
-      # (pydantic + invokeai.app/backend). Skip the [test] extra to keep CI fast.
-      - name: install python dependencies
-        run: uv pip install --editable .
-
-      # Node (needed for docs build)
-      - name: setup node
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22.12.0'
-
-      - name: setup pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-          run_install: false
-
-      - name: install docs dependencies
-        run: pnpm install --prefer-frozen-lockfile
-        working-directory: docs
-
-      # Checks
-      - name: verify generated docs data
-        run: pnpm run check-docs-data
-        working-directory: docs
-
-      - name: build docs
-        run: pnpm build
-        working-directory: docs
-        env:
-          DEPLOY_TARGET: ${{ github.event_name == 'workflow_dispatch' && inputs.deploy_target || github.ref == 'refs/heads/main' && 'ghpages' || 'custom' }}
-
-      # Upload artifact for deploy (main branch only)
-      - name: upload pages artifact
-        if: github.ref == 'refs/heads/main'
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: docs/dist
-
-  deploy:
-    if: github.ref == 'refs/heads/main'
-    needs: check-and-build
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pages: write
-      id-token: write
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    steps:
-      - name: deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

.github/workflows/mkdocs-material.yml

@@ -0,0 +1,49 @@
+# This is a mostly a copy-paste from https://github.com/squidfunk/mkdocs-material/blob/master/docs/publishing-your-site.md
+
+name: mkdocs
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    if: github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+    env:
+      REPO_URL: '${{ github.server_url }}/${{ github.repository }}'
+      REPO_NAME: '${{ github.repository }}'
+      SITE_URL: 'https://${{ github.repository_owner }}.github.io/InvokeAI'
+
+    steps:
+      - name: checkout
+        uses: actions/checkout@v5
+
+      - name: setup python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: set cache id
+        run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+
+      - name: use cache
+        uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+
+      - name: install dependencies
+        run: python -m pip install ".[docs]"
+
+      - name: build & deploy
+        run: mkdocs gh-deploy --force

.github/workflows/translations.yml

@@ -1,78 +0,0 @@
-name: Crowdin Translations
-
-on:
-  # Allow manual runs from the Actions tab
-  workflow_dispatch:
-    inputs:
-      upload_sources:
-        description: 'Upload source strings to Crowdin'
-        type: boolean
-        default: true
-      download_translations:
-        description: 'Download translations from Crowdin'
-        type: boolean
-        default: true
-
-  # Upload sources & download translations when source files change on main
-  push:
-    branches:
-      - main
-    paths:
-      - 'invokeai/frontend/web/public/locales/en.json'
-      - 'docs/src/content/i18n/en.json'
-      - 'docs/src/content/docs/**/*.md'
-      - 'docs/src/content/docs/**/*.mdx'
-      - '!docs/src/content/docs/[a-z][a-z]/**'
-      - '!docs/src/content/docs/[a-z][a-z]-*/**'
-      - 'crowdin.yml'
-
-permissions:
-  contents: write
-  pull-requests: write
-
-jobs:
-  crowdin-sync:
-    name: Sync with Crowdin
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Crowdin Sync
-        uses: crowdin/github-action@v2
-        with:
-          # Upload sources on push to main or when manually requested
-          upload_sources: ${{ github.event_name != 'workflow_dispatch' || inputs.upload_sources }}
-          upload_translations: false
-
-          # Download translations on push to main or when manually requested
-          download_translations: ${{ github.event_name != 'workflow_dispatch' || inputs.download_translations }}
-
-          # PR settings for downloaded translations
-          create_pull_request: true
-          pull_request_title: 'i18n: update translations from Crowdin'
-          pull_request_body: |
-            Automated pull request from [Crowdin](https://crowdin.com).
-
-            This PR updates translations for:
-            - **Web App UI** (`invokeai/frontend/web/public/locales/`)
-            - **Documentation UI Strings** (`docs/src/content/i18n/`)
-            - **Documentation Content** (`docs/src/content/docs/<locale>/`)
-          pull_request_base_branch_name: main
-          pull_request_labels: 'i18n'
-
-          # Commit settings
-          localization_branch_name: crowdin/translations
-          commit_message: 'i18n: update translations from Crowdin'
-
-          # Use the config file at the repo root
-          config: crowdin.yml
-
-          # Skip untranslated strings/files to keep partial translations clean
-          download_translations_args: '--skip-untranslated-strings'
-
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
-          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}

.gitignore

@@ -179,7 +179,6 @@ cython_debug/
 
 # Scratch folder
 .scratch/
-worktrees/
 .vscode/
 .zed/
 

Makefile

@@ -12,13 +12,12 @@ help:
 	@echo "mypy-all                 Run mypy ignoring the config in pyproject.tom but still ignoring missing imports"
 	@echo "test                     Run the unit tests."
 	@echo "update-config-docstring  Update the app's config docstring so mkdocs can autogenerate it correctly."
-	@echo "frontend-install         Install the pnpm modules needed for the frontend"
-	@echo "frontend-build           Build the frontend for localhost:9090"
-	@echo "frontend-test            Run the frontend test suite once"
+	@echo "frontend-install         Install the pnpm modules needed for the front end"
+	@echo "frontend-build           Build the frontend in order to run on localhost:9090"
 	@echo "frontend-dev             Run the frontend in developer mode on localhost:5173"
 	@echo "frontend-typegen         Generate types for the frontend from the OpenAPI schema"
-	@echo "frontend-lint            Run frontend checks and fixable lint/format steps"
-	@echo "wheel                    Build the wheel for the current version"
+	@echo "frontend-prettier        Format the frontend using lint:prettier"
+	@echo "wheel            	Build the wheel for the current version"
 	@echo "tag-release              Tag the GitHub repository with the current version (use at release time only!)"
 	@echo "openapi                  Generate the OpenAPI schema for the app, outputting to stdout"
 	@echo "docs                     Serve the mkdocs site with live reload"
@@ -58,10 +57,6 @@ frontend-install:
 frontend-build:
 	cd invokeai/frontend/web && pnpm build
 
-# Run the frontend test suite once
-frontend-test:
-	cd invokeai/frontend/web && pnpm run test:run
-
 # Run the frontend in dev mode
 frontend-dev:
 	cd invokeai/frontend/web && pnpm dev

README.md

@@ -58,39 +58,15 @@ Invoke offers a fully featured workflow management solution, enabling users to c
 
 Invoke features an organized gallery system for easily storing, accessing, and remixing your content in the Invoke workspace. Images can be dragged/dropped onto any Image-base UI element in the application, and rich metadata within the Image allows for easy recall of key prompts or settings used in your workflow.
 
-### Model Support
-- SD 1.5
-- SD 2.0
-- SDXL
-- SD 3.5 Medium
-- SD 3.5 Large
-- CogView 4
-- Flux.1 Dev
-- Flux.1 Schnell
-- Flux.1 Kontext
-- Flux.1 Krea
-- Flux Redux
-- Flux Fill
-- Flux.2 Klein 4B
-- Flux.2 Klein 9B
-- Z-Image Turbo
-- Z-Image Base
-- Anima
-- Qwen Image
-- Qwen Image Edit
-- Nano Banana (API Only)
-- GPT Image (API Only)
-- Wan (API Only)
-
 ### Other features
 
-- Support for ckpt, diffusers, and some gguf models
+- Support for both ckpt and diffusers models
+- SD1.5, SD2.0, SDXL, and FLUX support
 - Upscaling Tools
 - Embedding Manager & Support
 - Model Manager & Support
 - Workflow creation & management
 - Node-Based Architecture
-- Object Segmentation & Selection Models (SAM / SAM2)
 
 ## Contributing
 
@@ -106,14 +82,14 @@ Invoke is a combined effort of [passionate and talented people from across the w
 
 Original portions of the software are Copyright © 2024 by respective contributors.
 
-[features docs]: https://invoke.ai/
-[faq]: https://invoke.ai/troubleshooting/faq/
-[contributors]: https://invoke.ai/contributing/contributors/
+[features docs]: https://invoke-ai.github.io/InvokeAI/features/database/
+[faq]: https://invoke-ai.github.io/InvokeAI/faq/
+[contributors]: https://invoke-ai.github.io/InvokeAI/contributing/contributors/
 [github issues]: https://github.com/invoke-ai/InvokeAI/issues
-[docs home]: https://invoke.ai
-[installation docs]: https://invoke.ai/start-here/installation/
+[docs home]: https://invoke-ai.github.io/InvokeAI
+[installation docs]: https://invoke-ai.github.io/InvokeAI/installation/
 [#dev-chat]: https://discord.com/channels/1020123559063990373/1049495067846524939
-[contributing docs]: https://invoke.ai/contributing/
+[contributing docs]: https://invoke-ai.github.io/InvokeAI/contributing/
 [CI checks on main badge]: https://flat.badgen.net/github/checks/invoke-ai/InvokeAI/main?label=CI%20status%20on%20main&cache=900&icon=github
 [CI checks on main link]: https://github.com/invoke-ai/InvokeAI/actions?query=branch%3Amain
 [discord badge]: https://flat.badgen.net/discord/members/ZmtBAhwWhy?icon=discord

docker/README.md

@@ -109,7 +109,7 @@ CONTAINER_UID=1000
 GPU_DRIVER=cuda
 ```
 
-Any environment variables supported by InvokeAI can be set here. See the [Configuration docs](https://invoke.ai/configuration/invokeai-yaml/) for further detail.
+Any environment variables supported by InvokeAI can be set here. See the [Configuration docs](https://invoke-ai.github.io/InvokeAI/features/CONFIGURATION/) for further detail.
 
 ---
 

docs-old/contributing/CANVAS_PROJECTS/CANVAS_PROJECTS.md

@@ -1,205 +0,0 @@
-# Canvas Projects — Technical Documentation
-
-## Overview
-
-Canvas Projects provide a save/load mechanism for the entire canvas state. The feature serializes all canvas entities, generation parameters, reference images, and their associated image files into a ZIP-based `.invk` file. On load, it restores the full state, handling image deduplication and re-uploading as needed.
-
-## File Format
-
-The `.invk` file is a standard ZIP archive with the following structure:
-
-```
-project.invk
-├── manifest.json
-├── canvas_state.json
-├── params.json
-├── ref_images.json
-├── loras.json
-└── images/
-    ├── {image_name_1}.png
-    ├── {image_name_2}.png
-    └── ...
-```
-
-### manifest.json
-
-Schema version and metadata. Validated on load with Zod.
-
-```json
-{
-  "version": 1,
-  "appVersion": "5.12.0",
-  "createdAt": "2026-02-26T12:00:00.000Z",
-  "name": "My Canvas Project"
-}
-```
-
-| Field | Type | Description |
-|---|---|---|
-| `version` | `number` | Schema version, currently `1`. Used for migration logic on load. |
-| `appVersion` | `string` | InvokeAI version that created the file. Informational only. |
-| `createdAt` | `string` | ISO 8601 timestamp. |
-| `name` | `string` | User-provided project name. Also used as the download filename. |
-
-### canvas_state.json
-
-The serialized canvas entity tree. Type: `CanvasProjectState`.
-
-```typescript
-type CanvasProjectState = {
-  rasterLayers: CanvasRasterLayerState[];
-  controlLayers: CanvasControlLayerState[];
-  inpaintMasks: CanvasInpaintMaskState[];
-  regionalGuidance: CanvasRegionalGuidanceState[];
-  bbox: CanvasState['bbox'];
-  selectedEntityIdentifier: CanvasState['selectedEntityIdentifier'];
-  bookmarkedEntityIdentifier: CanvasState['bookmarkedEntityIdentifier'];
-};
-```
-
-Each entity contains its full state including all canvas objects (brush lines, eraser lines, rect shapes, images). Image objects reference files by `image_name` which correspond to files in the `images/` folder.
-
-### params.json
-
-The complete generation parameters state (`ParamsState`). Optional on load (older files may not have it). This includes all fields from the params Redux slice:
-
-- Prompts (positive, negative, prompt history)
-- Core generation settings (seed, steps, CFG scale, guidance, scheduler, iterations)
-- Model selections (main model, VAE, FLUX VAE, T5 encoder, CLIP embed models, refiner, Z-Image models, Klein models)
-- Dimensions (width, height, aspect ratio)
-- Img2img strength
-- Infill settings (method, tile size, patchmatch downscale, color)
-- Canvas coherence settings (mode, edge size, min denoise)
-- Refiner parameters (steps, CFG scale, scheduler, aesthetic scores, start)
-- FLUX-specific settings (scheduler, DyPE preset/scale/exponent)
-- Z-Image-specific settings (scheduler, seed variance)
-- Upscale settings (scheduler, CFG scale)
-- Seamless tiling, mask blur, CLIP skip, VAE precision, CPU noise, color compensation
-
-### ref_images.json
-
-Global reference image entities (`RefImageState[]`). These are IP-Adapter / FLUX Redux configs with `CroppableImageWithDims` containing both original and cropped image references. Optional on load.
-
-### loras.json
-
-Array of LoRA configurations (`LoRA[]`). Each entry contains:
-
-```typescript
-type LoRA = {
-  id: string;
-  isEnabled: boolean;
-  model: ModelIdentifierField;
-  weight: number;
-};
-```
-
-Optional on load. Like models, LoRA identifiers are stored as-is — if a LoRA is not installed when loading, the entry is restored but may not be usable.
-
-### images/
-
-All image files referenced anywhere in the state. Keyed by their original `image_name`. On save, each image is fetched from the backend via `GET /api/v1/images/i/{name}/full` and stored as-is.
-
-## Key Source Files
-
-| File | Purpose |
-|---|---|
-| `features/controlLayers/util/canvasProjectFile.ts` | Types, constants, image name collection, remapping, existence checking |
-| `features/controlLayers/hooks/useCanvasProjectSave.ts` | Save hook — collects Redux state, fetches images, builds ZIP |
-| `features/controlLayers/hooks/useCanvasProjectLoad.ts` | Load hook — parses ZIP, deduplicates images, dispatches state |
-| `features/controlLayers/components/SaveCanvasProjectDialog.tsx` | Save name dialog + `useSaveCanvasProjectWithDialog` hook |
-| `features/controlLayers/components/LoadCanvasProjectConfirmationAlertDialog.tsx` | Load confirmation dialog + `useLoadCanvasProjectWithDialog` hook |
-| `features/controlLayers/components/Toolbar/CanvasToolbarProjectMenuButton.tsx` | Toolbar dropdown UI |
-| `features/controlLayers/store/canvasSlice.ts` | `canvasProjectRecalled` Redux action |
-
-## Save Flow
-
-1. User clicks "Save Canvas Project" → `SaveCanvasProjectDialog` opens asking for a project name
-2. On confirm, `saveCanvasProject(name)` is called
-3. Read Redux state via selectors: `selectCanvasSlice()`, `selectParamsSlice()`, `selectRefImagesSlice()`, `selectLoRAsSlice()`
-4. Build `CanvasProjectState` from the canvas slice; use `paramsState` directly for params
-5. Walk all entities to collect every `image_name` reference via `collectImageNames()`:
-   - `CanvasImageState.image.image_name` in layer/mask objects
-   - `CroppableImageWithDims.original.image.image_name` in global ref images
-   - `CroppableImageWithDims.crop.image.image_name` in cropped ref images
-   - `ImageWithDims.image_name` in regional guidance ref images
-6. Fetch each image from the backend API
-7. Build ZIP with JSZip: add `manifest.json` (including `name`), `canvas_state.json`, `params.json`, `ref_images.json`, and all images into `images/`
-8. Sanitize the name for filesystem use and generate blob, trigger download as `{name}.invk`
-
-## Load Flow
-
-1. User selects `.invk` file → confirmation dialog opens
-2. On confirm, parse ZIP with JSZip
-3. Validate manifest version via Zod schema
-4. Read `canvas_state.json`, `params.json` (optional), `ref_images.json` (optional)
-5. Collect all `image_name` references from the loaded state
-6. **Deduplicate images**: for each referenced image, check if it exists on the server via `getImageDTOSafe(image_name)`
-   - Already exists → skip (no upload)
-   - Missing → upload from ZIP via `uploadImage()`, record `oldName → newName` mapping
-7. Remap all `image_name` values in the loaded state using the mapping (only for re-uploaded images whose names changed)
-8. Dispatch Redux actions:
-   - `canvasProjectRecalled()` — restores all canvas entities, bbox, selected/bookmarked entity
-   - `refImagesRecalled()` — restores global reference images
-   - `paramsRecalled()` — replaces the entire params state in one action
-   - `loraAllDeleted()` + `loraRecalled()` — restores LoRAs
-9. Show success/error toast
-
-## Image Name Collection & Remapping
-
-The `canvasProjectFile.ts` utility provides two parallel sets of functions:
-
-**Collection** (`collectImageNames`): Walks the entire state tree and returns a `Set<string>` of all referenced `image_name` values. This is used by both save (to know which images to fetch) and load (to know which images to check/upload).
-
-**Remapping** (`remapCanvasState`, `remapRefImages`): Deep-clones state objects and replaces `image_name` values using a `Map<string, string>` mapping. Only images that were re-uploaded with a different name are remapped. Images that already existed on the server are left unchanged.
-
-Both walk the same paths through the state tree:
-- Layer/mask objects → `CanvasImageState.image.image_name`
-- Regional guidance ref images → `ImageWithDims.image_name`
-- Global ref images → `CroppableImageWithDims.original.image.image_name` and `.crop.image.image_name`
-
-## Extending the Format
-
-### Adding new optional data (non-breaking)
-
-Add a new JSON file to the ZIP. No version bump needed.
-
-1. **Save**: Add `zip.file('new_data.json', JSON.stringify(data))` in `useCanvasProjectSave.ts`
-2. **Load**: Read with `zip.file('new_data.json')` in `useCanvasProjectLoad.ts` — check for `null` so older project files without it still load
-3. **Dispatch**: Add the appropriate Redux action to restore the data
-
-### Adding new entity types with images
-
-1. Extend `CanvasProjectState` type in `canvasProjectFile.ts`
-2. Add collection logic in `collectImageNames()` to walk the new entity's objects
-3. Add remapping logic in `remapCanvasState()` to update image names
-4. Include the new entity array in both save and load hooks
-5. Handle it in the `canvasProjectRecalled` reducer in `canvasSlice.ts`
-
-### Breaking schema changes
-
-1. Bump `CANVAS_PROJECT_VERSION` in `canvasProjectFile.ts`
-2. Update the Zod manifest schema: `version: z.union([z.literal(1), z.literal(2)])`
-3. Add migration logic in the load hook: check version, transform v1 → v2 before dispatching
-
-## UI Architecture
-
-### Save dialog
-
-The save flow uses a **nanostore atom** (`$isOpen`) to control the `SaveCanvasProjectDialog`:
-
-1. `useSaveCanvasProjectWithDialog()` — returns a callback that sets `$isOpen` to `true`
-2. `SaveCanvasProjectDialog` (singleton in `GlobalModalIsolator`) — renders an `AlertDialog` with a name input
-3. On save → calls `saveCanvasProject(name)` and closes the dialog
-4. On cancel → closes the dialog
-
-### Load dialog
-
-The load flow uses a **nanostore atom** (`$pendingFile`) to decouple the file dialog from the confirmation dialog:
-
-1. `useLoadCanvasProjectWithDialog()` — opens a programmatic file input (`document.createElement('input')`)
-2. On file selection → sets `$pendingFile` atom
-3. `LoadCanvasProjectConfirmationAlertDialog` (singleton in `GlobalModalIsolator`) — subscribes to `$pendingFile` via `useStore()`
-4. On accept → calls `loadCanvasProject(file)` and clears the atom
-5. On cancel → clears the atom
-
-The programmatic file input approach was chosen because the context menu component uses `isLazy: true`, which unmounts the DOM tree when the menu closes — a hidden `<input>` element inside the menu would be destroyed before the file dialog returns.

docs-old/features/Lasso_tool.md

@@ -1,32 +0,0 @@
-Lasso Tool
-===========
-
-- The Lasso tool creates selections and inpaint masks by drawing freehand or polygonal regions on the canvas.
-
-How to open the Lasso tool
---------------------------
-- Click the Lasso icon in the toolbar.
-- Hotkey: press `L` (default). The hotkey is shown in the tool's tooltip and can be customized in Hotkeys settings.
-
-Modes
------
-- Freehand (default)
-  - Hold the pointer and drag to draw a continuous contour.
-  - Long segments are broken into intermediate points to keep the line continuous.
-  - Very long strokes may be simplified after drawing to reduce point count for performance.
-
-- Polygon
-  - Click to place points; click the first point (or a point near it) to close the polygon.
-  - The tool snaps the closing point to the start for precise closures.
-
-Basic interactions
-------------------
-- Switch modes with the mode toggle in the toolbar.
-- To close a polygon: click the starting point again or click near it — the tool aligns the final point to the start to complete the shape.
-- The selection will be added to the current Inpaint Mask layer. If no Inpaint Mask layer exists, a new one will be created automatically.
-
-Tips & behavior
----------------
-- Hold `Space` to temporarily switch to the View tool for panning and zooming; release `Space` to return to the Lasso tool and continue drawing.
-- When using the Polygon mode, you can hold `Shift` to snap points to horizontal, vertical, or 45-degree angles for more precise shapes.
-- Hold `Ctrl` (Windows/Linux) or `Command` (macOS) while drawing to subtract from the current selection instead of adding to it.

docs-old/features/canvas_projects.md

@@ -1,56 +0,0 @@
----
-title: Canvas Projects
----
-
-# :material-folder-zip: Canvas Projects
-
-## Save and Restore Your Canvas Work
-
-Canvas Projects let you save your entire canvas setup to a file and load it back later. This is useful when you want to:
-
-- **Switch between tasks** without losing your current canvas arrangement
-- **Back up complex setups** with multiple layers, masks, and reference images
-- **Share canvas layouts** with others or transfer them between machines
-- **Recover from deleted images** — all images are embedded in the project file
-
-## What Gets Saved
-
-A canvas project file (`.invk`) captures everything about your current canvas session:
-
-- **All layers** — raster layers, control layers, inpaint masks, regional guidance
-- **All drawn content** — brush strokes, pasted images, eraser marks
-- **Reference images** — global IP-Adapter / FLUX Redux images with crop settings
-- **Regional guidance** — per-region prompts and reference images
-- **Bounding box** — position, size, aspect ratio, and scale settings
-- **All generation parameters** — prompts, seed, steps, CFG scale, guidance, scheduler, model, VAE, dimensions, img2img strength, infill settings, canvas coherence, refiner settings, FLUX/Z-Image specific parameters, and more
-- **LoRAs** — all added LoRA models with their weights and enabled/disabled state
-
-## How to Save a Project
-
-You can save from two places:
-
-1. **Toolbar** — Click the **Archive icon** in the canvas toolbar, then select **Save Canvas Project**
-2. **Context menu** — Right-click the canvas, open the **Project** submenu, then select **Save Canvas Project**
-
-A dialog will ask you to enter a **project name**. This name is used as the filename (e.g., entering "My Portrait" saves as `My Portrait.invk`) and is stored inside the project file.
-
-## How to Load a Project
-
-1. **Toolbar** — Click the **Archive icon**, then select **Load Canvas Project**
-2. **Context menu** — Right-click the canvas, open the **Project** submenu, then select **Load Canvas Project**
-
-A file dialog will open. Select your `.invk` file. You will see a confirmation dialog warning that loading will replace your current canvas. Click **Load** to proceed.
-
-### What Happens on Load
-
-- Your current canvas is **completely replaced** — all existing layers, masks, reference images, and parameters are overwritten
-- Images that are already present on your InvokeAI server are reused automatically (no duplicate uploads)
-- Images that were deleted from the server are re-uploaded from the project file
-- If the saved model is not installed on your system, the model identifier is still restored — you will need to select an available model manually
-
-## Good to Know
-
-- **No undo** — Loading a project replaces your canvas entirely. There is no way to undo this action, so save your current project first if you want to keep it.
-- **Image deduplication** — When loading, images already on your server are not re-uploaded. Only missing images are uploaded from the project file.
-- **File size** — The `.invk` file size depends on the number and resolution of images in your canvas. A project with many high-resolution layers can be large.
-- **Model availability** — The project saves which model was selected, but does not include the model itself. If the model is not installed when you load the project, you will need to select a different one.

docs/.gitignore

@@ -1,21 +0,0 @@
-# build output
-dist/
-# generated types
-.astro/
-
-# dependencies
-node_modules/
-
-# logs
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-
-
-# environment variables
-.env
-.env.production
-
-# macOS-specific files
-.DS_Store

docs/README.md

@@ -1 +0,0 @@
-# Invoke AI Documentation