# Development Roadmap ## YTDescGen — Phased Development Plan > **Status (2026-11-17): maintenance mode, from v1.6.0.** YTDescGen is > feature-complete: it stays maintained but takes no new features — see > [Maintenance mode](#maintenance-mode--from-v160) below. Phases 1–4 are the > original plan, kept as a record; notes added beside or under an item say > what has changed since. Every release is listed in > [CHANGELOG.md](../CHANGELOG.md). Phase 5 and the backlog are frozen. --- ## Phase 1 — MVP Core (Priority: P0) ✅ COMPLETED 2026-04-07 **Goal**: Ứng dụng web chạy được, generate title + description + tags, copy to clipboard. **Estimated**: 3-4 days | **Actual**: 1 day ### Tasks ``` 1.1 Project scaffold - [x] Vite + React 18 + TypeScript setup - [x] Tailwind CSS configuration (dark theme default) - [x] ESLint + Prettier config - [x] Directory structure per CLAUDE.md - [x] Package.json scripts 1.2 Config layer - [x] src/config/video-types.ts (7 initial types) - [x] src/config/genres.ts (10 initial genres) - [x] src/config/platforms.ts (7 platforms) - [x] src/config/rig-fields.ts - [x] src/config/social-fields.ts - [x] src/config/defaults.ts 1.3 i18n setup - [x] i18next + react-i18next install & config - [x] locales/en/ui.json + templates.json - [x] locales/vi/ui.json + templates.json - [x] locales/ja/ui.json + templates.json - [x] Locale validation script 1.4 Core engine - [x] engine/types.ts - [x] engine/title-builder.ts + tests - [x] engine/description-builder.ts + tests - [x] engine/tag-generator.ts + tests - [x] engine/template-renderer.ts (orchestrator) 1.5 State management - [x] Zustand setup - [x] editor-store.ts (form state) - [x] settings-store.ts (theme, default language) 1.6 UI components - [x] ui/ primitives: Button, Input, Textarea, Toggle, ChipGroup, Select - [x] editor/ components: VideoTypeSelector, LanguageSelector, GenreSelector - [x] editor/ components: GameInfoForm, VideoSettingsForm, TimestampEditor - [x] editor/ components: StoreLinkEditor, RigEditor, SocialEditor, WarningToggles - [x] editor/ components: QuickPreview - [x] output/ components: OutputPreview, CopyButton, CharCounter, CopyAllBar - [x] layout/ components: AppShell, Header, Sidebar 1.7 Pages - [x] EditorPage (form + quick preview) - [x] OutputPage (title + desc + tags + copy) - [x] React Router setup (HashRouter) (v1.0.0: real paths on the web; hash routes only in the desktop/Android apps) 1.8 Testing - [x] Vitest config - [x] Engine unit tests (title, description, tags) — 42 tests - [ ] Smoke tests for main pages (deferred to Phase 3; still open — the suite runs in Node without a DOM, see the backlog) 1.9 CI/CD - [x] GitHub Actions: lint + typecheck + test - [x] GitHub Actions: deploy to GitHub Pages (retired in v1.0.0 — Cloudflare Workers Builds deploys ytgenerator.stream from main; see HOSTING.md) ### Definition of Done - [x] User can select video type, language, genre - [x] User can enter game name, timestamps, store links, rig, social, warnings - [x] Title, description, and tags generate correctly in EN/VI/JA - [x] Copy buttons work for title, description, tags, and all - [x] Character counts displayed (5000 desc, 500 tags) - [x] CI passes, deploys to GitHub Pages (ytgenerator.stream since v1.0.0) ``` --- ## Phase 2 — Profiles & Presets (Priority: P1) ✅ COMPLETED 2026-04-07 **Goal**: Lưu thông tin tái sử dụng, không phải nhập lại mỗi lần. **Estimated**: 2-3 days | **Actual**: 1 day ### Tasks ``` 2.1 Profile system - [x] profile-store.ts (Zustand + persist) - [x] ProfileSaveForm component - [x] ProfileList + ProfileCard components - [x] Load profile → populate editor form - [x] Delete profile with confirmation - [x] Multiple profiles support 2.2 Game preset system - [x] preset-store.ts (Zustand + persist) - [x] PresetSaveForm + PresetCard + PresetList + PresetSelector - [x] Save game (name + genre + platform + store links + warnings) - [x] Load preset → populate game fields - [x] Preset selector dropdown in editor 2.3 ProfilesPage - [x] Profile management tab - [x] Game preset management tab - [x] Import/Export JSON 2.4 Auto-save draft - [x] Debounced save of editor state to localStorage (via Zustand persist) - [x] Restore on page load - [x] Clear draft button + DraftIndicator 2.5 Expand content - [x] Add video types: dlc, newgame_plus, challenge, side_quest, secret (12 total) - [x] Add genres: fighting, stealth, survival_craft, roguelike, metroidvania (15 total) - [x] Add social fields: twitch, tiktok, instagram, streamlabs (12 total) - [x] Add rig fields: motherboard, controller (8 total) - [x] Add store: humble, amazon (9 total) 2.6 Foundation additions - [x] Modal + ConfirmDialog UI primitives - [x] Import/Export utility (src/utils/import-export.ts) - [x] UUID utility (src/utils/uuid.ts) - [x] Updated i18n: 134 UI keys + 41 template keys across EN/VI/JA ### Definition of Done - [x] User creates profile → social/rig/channel info saved - [x] User loads profile → form populated instantly - [x] User creates game preset → reused across parts - [x] Form state auto-saved, survives page reload - [x] Export/Import profiles as JSON works ``` --- ## Phase 3 — Polish & Advanced Features (Priority: P1-P2) ✅ COMPLETED 2026-04-07 **Goal**: Batch mode, history, keyboard shortcuts, theme. **Estimated**: 2-3 days | **Actual**: 1 day ### Tasks ``` 3.1 History system - [x] history-store.ts (max entries, auto-prune, configurable limit) - [x] HistoryPage with list view - [x] Copy from history (title, description, tags) - [x] Delete history entries - [x] Search/filter history by game name or title - [x] Auto-save to history on OutputPage view (v1.0.0: one entry per video, updated in place) 3.2 Batch mode - [x] BatchPage UI - [x] Same game, different parts (start/end range) - [x] Generate N outputs at once (max 100) - [x] Copy all as combined text or individual 3.3 Multi-language output - [x] Generate output in multiple languages simultaneously - [x] Tab-based display per language - [x] Copy per language or copy all languages combined 3.4 Settings page - [x] SettingsPage component - [x] Theme toggle (dark/light) - [x] Default UI language, output language, genre preferences - [x] Tag generation options (multilingual, trending on/off, hashtag count) - [x] Editor settings (auto-save, show char count, compact tags) - [x] History limit setting (10-500) 3.5 Keyboard shortcuts - [x] Global keyboard listener (useKeyboardShortcuts hook) - [x] Ctrl+Enter (go to output), Ctrl+Shift+C (copy all), Ctrl+S (save draft) (v1.0.0: Ctrl/⌘+S saves the output to History — the draft saves itself; Ctrl/⌘+K opens the command palette) - [x] Ctrl+/ shortcut help modal 3.6 UX Polish - [x] Toast notifications for copy/save/delete (react-hot-toast; sonner since v1.0.0) - [x] Responsive layout (mobile-first, lg breakpoint for sidebar) - [x] Scrollable tab bar for mobile - [x] Empty states for all list pages - [x] Lazy-loaded pages (React.lazy + Suspense) 3.7 Expand languages - [x] Spanish (es) locale files (184 UI + 45 template keys) - [x] Korean (ko) locale files - [x] Chinese Simplified (zh) locale files 3.8 Expand genres to 25 + video types to 14 - [x] 10 new genres: mmo, rhythm, puzzle, tower_defense, card_game, battle_royale, crpg, tactical, space, farming - [x] 2 new video types: comparison, guide (14 total) - [x] Tag pools for each new genre and video type - [x] Settings wiring: showCharCount, compactTagDisplay into OutputPreview ### Definition of Done - [x] Batch generate 10 parts in under 30 seconds - [x] History page shows last N generated outputs (configurable) - [x] Dark/Light theme works correctly - [x] Keyboard shortcuts functional (Ctrl+Enter, Ctrl+Shift+C, Ctrl+S, Ctrl+/) - [x] 6 languages, 25 genres, 14 video types ``` --- ## Phase 4 — Desktop App (Priority: P2) ✅ COMPLETED 2026-04-08 **Goal**: Đóng gói thành ứng dụng desktop bằng Tauri. **Estimated**: 2-3 days | **Actual**: 1 day ### Tasks ``` 4.1 Tauri setup - [x] Install Tauri CLI v2 + dependencies (@tauri-apps/api, plugins) - [x] src-tauri/ scaffold (Cargo.toml, lib.rs, main.rs, build.rs) - [x] tauri.conf.json configuration (Tauri v2 format) - [x] App icons (all sizes via cargo tauri icon) - [x] Capabilities (default.json with dialog, fs, shell permissions) (v1.0.0: only core + opener; the fs and shell plugins are removed) 4.2 Desktop features - [x] Native file save/load via Tauri commands (save_to_file, read_from_file) (v1.0.0: replaced by name-only commands under the app's data folder and Save / Open dialogs run from Rust) - [x] Platform detection (IS_TAURI flag) - [x] File ops with web fallback (src/utils/file-ops.ts) - [x] System tray with Show/Quit menu - [x] Left-click tray to show window 4.3 Auto-update - [ ] Tauri updater configuration (deferred — needs signed releases) - [ ] GitHub Releases integration - [ ] Update notification UI 4.4 Build pipeline - [x] GitHub Actions: release-desktop.yml (Windows + macOS cross-compile) (now Windows, macOS and Linux; Android via release-android.yml) - [x] Tag-triggered release (v* tags) - [x] Verified local build: MSI 4.1MB, NSIS 2.7MB, EXE 14MB 4.5 Platform-specific - [x] Windows: MSI + NSIS installers built successfully - [x] macOS: built on the macos-14 CI runner (Apple Silicon .app) - [x] Offline functionality verified (all bundled, no API calls) - [x] Vite base URL conditional (/ for Tauri, /yt-desc-gen/ for web) (v1.0.0: / for both) ### Definition of Done - [x] Windows installer < 15MB (4.1MB MSI), installs and runs - [x] macOS .app < 15MB (CI-only, not locally testable; 4.1 MB `.app.tar.gz` in v1.1.0) - [ ] Auto-update from GitHub Releases (deferred — needs signing) - [x] All web features work identically in desktop - [x] Offline mode fully functional ``` --- ## v1.0.0 — Stable Release ✅ SHIPPED 2026-09-30 **Goal**: A stable 1.0 on its own domain, with data that is right. Web, desktop and Android all ship as 1.0.0 — the full list is in [CHANGELOG.md](../CHANGELOG.md#v100--2026-09-30). ### Contents ``` - [x] Web app at ytgenerator.stream — Cloudflare Worker, deployed by Workers Builds from main; GitHub Pages retired (moving notice until 2026-11-29) - [x] Turnstile check before the web app; cookieless Web Analytics (web only); legal pages served in-site; terms version 2 - [x] New interface — design system, app shell with a bottom bar on phones, command palette (Ctrl/⌘+K), live preview, YouTube preview - [x] Backup & restore — preview (new / already here / different), merge or replace, undo, drag-and-drop, automatic desktop backups, History as CSV - [x] Quick start — profile + preset pickers, Next part, New video same game, Start over keeps the channel - [x] Faster entry — store links pasted anywhere, game-name suggestions, title shapes + Title order, Copy All with tags, Batch Part / Demo part, Ctrl/⌘+S saves to History - [x] Data that is right — GPU catalog and hardware names, tags counted the way YouTube counts them, chapter check + Tidy up, one History entry per video, per-field copy gating - [x] Catalogs — EA app, Ubisoft, Battle.net, Google Play, App Store, Meta Quest; YouTube, Threads, Kick, Reddit, Bilibili links; YouTube Shorts, X, Threads, Bluesky captions; five Vietnamese banks - [x] Desktop hardening — the webview never names a path, Save / Open dialogs run from Rust, fs and shell plugins removed, one tray icon - [x] CI — dependency review, workflow lint, OpenSSF Scorecard, REUSE, PR titles, Rust checks, coverage thresholds, bundle budget, licence allow-list, Cloudflare dry-run; every action pinned by SHA ``` --- ## v1.1.0 — Contacts ✅ SHIPPED 2026-10-03 A copyright / DMCA email and purpose words for the split contact block, an option to hide scrollbars, and copyright years checked in CI — [CHANGELOG.md](../CHANGELOG.md#v110--2026-10-03). ## v1.2.0 — AI disclosure ✅ SHIPPED 2026-10-12 Content warnings for games made with generative AI (a new group of seven), simulated gambling, in-game purchases and a tech note for upscaling / frame-generation artifacts; a test that every warning and tech note is translated; third-party notices, REUSE and the docs brought in line with the code — [CHANGELOG.md](../CHANGELOG.md#v120--2026-10-12). ## v1.3.0 — Toolchain ✅ SHIPPED 2026-10-22 TypeScript 7 (target ES2025), Node 26, React 19 refs, two rounds of dependency updates with five security alerts closed, SonarCloud at 0 open issues, Android app data kept out of cloud backups — [CHANGELOG.md](../CHANGELOG.md#v130--2026-10-22). Next for the toolchain: ES2026 once TypeScript 7.1 is stable. ## v1.3.1 — Maintenance ✅ SHIPPED 2026-10-26 Tauri 2.12.4, the desktop's Save / Open dialogs off the async workers, SonarCloud in CI with coverage, and this week's dependency updates with the one open security alert closed — [CHANGELOG.md](../CHANGELOG.md#v131--2026-10-26). ## v1.3.2 — Rate limiting ✅ SHIPPED 2026-10-27 The website answers floods with `429`: per-client limits in the Cloudflare Worker (Workers Rate Limiting bindings), behind a WAF rate limiting rule at the zone — [CHANGELOG.md](../CHANGELOG.md#v132--2026-10-27). ## v1.4.0 — LUT field, boss name tag ✅ SHIPPED 2026-11-06 A **LUT** field in My Rig, printed on its own line under the video editor (DaVinci Resolve's own LUTs offered while typing), the **boss's name as a tag** in Boss Fight and Boss No Hit videos, and this week's dependency updates — [CHANGELOG.md](../CHANGELOG.md#v140--2026-11-06). ## v1.5.0 — Upscaled video ✅ SHIPPED 2026-11-08 **Upscaled from** in Video settings, for footage upscaled in the video editor: a `[4K Upscaled]` title badge, an `Upscale: 1440p → 4K (…)` line in Video settings and an automatic tech note that fine detail may differ from the original image — [CHANGELOG.md](../CHANGELOG.md#v150--2026-11-08). ## v1.5.1 — Accessibility ✅ SHIPPED 2026-11-09 An accessibility statement ([ACCESSIBILITY.md](../ACCESSIBILITY.md), also in the Legal Center) and the fixes an audit against WCAG 2.2 AA turned up: AA contrast in both themes, generated text marked with its language, the page's name read out after a navigation, a switch for the single-key `?` shortcut, and zoom hotkeys in the desktop app — [CHANGELOG.md](../CHANGELOG.md#v151--2026-11-09). ## v1.5.2 — Maintenance ✅ SHIPPED 2026-11-10 Tauri 2.12.5 with the fixes its window, webview and single-instance layers collected, and this week's dependency updates; i18next stays on 26.6 to keep the initial load inside its budget — [CHANGELOG.md](../CHANGELOG.md#v152--2026-11-10). ## v1.6.0 — Maintenance mode begins ✅ SHIPPED 2026-11-17 The last feature release: DLSS 5 Neural Rendering, NVIDIA's x6 and Dynamic Multi Frame Generation and a Custom frame generation for every vendor in Video settings, and a Custom LUT that prints just "LUT applied". JetBrains Qodana joins SonarCloud, and the project enters [maintenance mode](#maintenance-mode--from-v160) — [CHANGELOG.md](../CHANGELOG.md#v160--2026-11-17). --- ## Maintenance mode — from v1.6.0 **Status**: ongoing since v1.6.0 (November 2026). YTDescGen is feature-complete. From 1.6.0 on it is maintained, not extended: no new features unless one is judged genuinely necessary. The accepted changes, and how out-of-scope issues and pull requests are closed, are in [CONTRIBUTING.md → Maintenance mode](../CONTRIBUTING.md#maintenance-mode): 1. Dependency updates on a regular schedule. 2. Security fixes: a dependency with a high or critical CVE, a serious runtime issue. 3. Major language, runtime and framework upgrades (Node 24 → 26, TypeScript 6 → 7). 4. Bug, UI/UX and accessibility fixes, and adding or removing an option in one of the app's lists when people really need it. 5. Translation fixes: wording that doesn't fit a culture or region, misleading spelling mistakes. 6. Cloudflare / Worker changes the platform forces. 7. Website incidents such as DDoS or bot spam. What 1.6.0 set up for it: - [x] **Policy**: README → Project status, CONTRIBUTING → Maintenance mode, SECURITY, MAINTAINERS, CLAUDE.md. - [x] **Issue forms**: the feature request form is gone; an Option request and a Translation or wording fix form joined Bug report and Accessibility barrier; a Scope checklist in the pull request template. - [x] **Auto-close**: `maintenance-triage.yml` closes, with a bilingual comment and the `out-of-scope` label, feature issues and `feat:` pull requests from outside contributors (`feat(options)`, `feat(a11y)` and `feat(i18n)` stay open), and anything the maintainer labels `out-of-scope`. - [x] **Qodana**: Qodana for JS and Qodana for Rust (Early Access) on every push and pull request, reported to Qodana Cloud, with a gate of zero problems. Known maintenance already queued: the GitHub Pages moving notice comes down on 2026-11-29 (issue #177); i18next 27 and Tauri 3 arrive as planned major upgrades when they are ready. --- ## Phase 5 — Extensions & Ecosystem (Priority: P2-P3) **Frozen while YTDescGen is in maintenance mode.** An item moves only if it falls under the [maintenance policy](../CONTRIBUTING.md#maintenance-mode). **Goal**: IDE extension, CLI, community features. **Estimated**: Ongoing ### Tasks ``` 5.1 CLI tool - [ ] Standalone Node.js CLI using engine/ - [ ] `npx ytdescgen generate --game "..." --type full --lang en` - [ ] JSON output mode for scripting - [ ] Config file support (.ytdescgen.json) 5.2 VS Code Extension - [ ] Command palette: "YTDescGen: Generate Description" - [ ] Webview panel with editor UI - [ ] Output to new editor tab - [ ] Settings sync with VS Code settings 5.3 Additional languages - [x] Portuguese — shipped as Brazilian Portuguese (pt-BR) in v0.38.0, together with Indonesian (id) - [ ] French, German, Russian, Thai, Arabic - [x] Community contribution guide for translations (docs/I18N.md, CONTRIBUTING.md) - [x] Locale validation CI check (npm run validate:locales in the required `check` job) 5.4 Template customization - [ ] Custom template editor in app - [ ] Template import/export - [ ] Template sharing (JSON format) (Full-form templates — every editor field — already export and import as JSON on Profiles › Templates; these items are about editing the description templates themselves.) 5.5 Quality of life - [ ] YouTube API integration (auto-apply description) - [ ] Tag trend analysis (what's trending for the genre) - [x] Multi-channel profile support — one profile per channel, as many as you like; Quick start picks one per video (v1.0.0) ``` --- ## Backlog (after v1.0.0) Ideas carried over from the v1.0.0 planning — not scheduled, and frozen while YTDescGen is in maintenance mode. ``` - [ ] Auto-fill game info from Steam through the Worker — needs rate limiting and a decision for the desktop app - [ ] More genres: Sports, Point & Click, MOBA, Party — the taxonomy is still to decide - [ ] PWA offline for the web — conflicts with the Turnstile gate in front of the app - [ ] PGP signature for security.txt - [ ] Smoke tests for the main pages — needs a DOM test environment (the suite runs in Node) ``` --- ## Timeline Summary | Phase | Scope | Days | Cumulative | | ------- | ------------------ | ------ | ---------- | | Phase 1 | MVP Core | 3-4 | 3-4 days | | Phase 2 | Profiles & Presets | 2-3 | 5-7 days | | Phase 3 | Polish & Advanced | 2-3 | 7-10 days | | Phase 4 | Desktop App | 2-3 | 9-13 days | | Phase 5 | Extensions | Frozen | — | **MVP usable after Phase 1** (~3-4 days). Full-featured after Phase 3 (~7-10 days). **v1.0.0 shipped on 2026-09-30; the current release is v1.6.0 (2026-11-17), the first in maintenance mode.**