Releases: nikatopu/dialogue-forge
Dialogue Forge v1.4.0 - Variables, Conditions & State Systems
Dialogue Forge v1.4.0 - Variables, Conditions & State Systems
This is the biggest Dialogue Forge update so far.
Dialogue Forge is no longer limited to static dialogue trees. With v1.4, conversations can react to game state through variables, conditions, and runtime logic, making it possible to build RPG dialogue systems, quest chains, merchants, companion relationships, and much more.
Variables
Added project-wide variables.
Supported types:
- Number
- Boolean
- String
Examples:
- gold
- reputation
- hasKey
- questState
- relationship
Variables can be created, edited, renamed, searched, and reused throughout a project.
Variable Actions
New action type:
Set Variable
Supported operations:
- Set
- Add
- Subtract
- Multiply
- Divide
- Toggle
Examples:
gold += 10
reputation += 1
hasKey = true
questState = "completed"
Conditions
Branches can now be gated by conditions.
Examples:
gold >= 5
hasKey == true
reputation > 10
Dialogue options only appear when their conditions are met.
Condition Groups
Added support for more advanced logic.
Examples:
gold >= 5
AND
reputation > 10
hasKey
OR
lockpickedDoor
Conditions are built visually using dropdowns and groups—no scripting required.
State-Aware Preview
Preview mode can now simulate gameplay state.
Before starting a preview, set variable values such as:
gold = 25
hasKey = true
questState = "started"
Dialogue behavior updates automatically based on those values.
Live State Tracking
Preview now includes a state panel showing:
- Current variables
- Recent variable changes
- Triggered events
- Runtime state updates
This makes testing complex dialogue flows significantly easier.
Validation Improvements
New validation rules detect:
- Missing variables
- Invalid references
- Broken conditions
- Type mismatches
Dialogue Forge now catches common state-related mistakes before export.
Template Upgrades
Built-in templates now use variables and conditions.
Updated:
- Merchant
- Quest Giver
- Companion Dialogue
- Combat Encounter
- Multi-Entry RPG
Templates now demonstrate real gameplay logic instead of static conversations.
Export Format
Exports now include:
- Variables
- Conditions
- Variable actions
Projects remain fully backward compatible through the migration system introduced in v1.3.2.
Why This Update Matters
With variables and conditions, Dialogue Forge moves beyond dialogue authoring and into narrative gameplay design.
You can now build:
- Shops
- Quest systems
- Reputation systems
- Relationship systems
- Inventory checks
- Conditional story paths
without writing a single line of code.
Thanks to everyone who provided feedback and helped shape this release.
Full Changelog: v1.3.3...v1.4.0
Dialogue Forge v1.3.3 - UI Architecture Refactor
Dialogue Forge v1.3.3 - UI Architecture Refactor
This release focuses on improving the internal frontend architecture of Dialogue Forge.
What's Changed
- Refactored the UI to follow Atomic Design principles (Atoms, Molecules, Organisms)
- Standardized component structure across the project
- Migrated styling to modular SCSS files
- Reduced duplicated UI and styling code
- Improved responsive styling organization
- Replaced scattered styling patterns with a more consistent system
- Added shared component conventions for future development
Why
This update doesn't add new user-facing features, but it creates a cleaner and more maintainable foundation for upcoming releases such as Variables & Conditions, Character Databases, Collaboration, and Runtime SDKs.
As always, existing projects remain fully compatible.
Full Changelog: v1.3.2...v1.3.3
Dialogue Forge v1.3.2 - Project Migration & Self-Healing Data
Dialogue Forge v1.3.2 - Project Migration & Self-Healing Data
This release focuses on something most users will never see, but every user benefits from: project compatibility.
As Dialogue Forge continues to evolve, older projects should never become unusable. v1.3.2 introduces a migration and repair system that automatically updates projects to the latest format whenever they are loaded.
Automatic Project Migrations
Projects now include version metadata.
When a project is opened:
- Version is checked
- Required migrations are applied
- Missing data is repaired
- Project is validated
- Updated data is saved automatically
This applies to both local and cloud projects.
Self-Healing Data
Dialogue Forge can now automatically repair common project issues.
Examples:
- Missing node fields
- Missing action properties
- Missing metadata
- Missing attributes
- Outdated project structures
Instead of failing to load, projects are repaired and opened normally.
Future-Proof Save System
A migration pipeline has been added to support future releases.
When new features are introduced, older projects will be upgraded automatically.
Examples:
- New node properties
- New action types
- New project settings
- Variable systems
- Future runtime features
Users won't need to manually update existing projects.
Cloud Project Upgrades
Cloud projects are now migrated automatically when opened.
If a project requires updates:
- Migrations run
- Data is repaired
- Project version is updated
- Changes are saved back to the cloud
All of this happens transparently.
Local Project Upgrades
Local projects now receive the same migration and repair process.
Opening an older project automatically updates it to the latest supported format.
No prompts required.
Validation Improvements
Additional validation now checks:
- Missing node data
- Invalid edges
- Broken references
- Outdated project structures
Issues are repaired whenever possible before the editor loads.
Backup Protection
Projects are backed up before migrations run.
This provides an additional safety layer when upgrading older projects.
Why This Update Matters
This release lays the foundation for future Dialogue Forge updates.
Whether a project was created in v1.0, v1.3, or a future release, the goal is simple:
Your projects should continue working.
Always.
No manual migration.
No broken saves.
No lost work.
Just open and continue creating.
Full Changelog: v1.3.1...v1.3.2
Dialogue Forge v1.3.1 - Local → Cloud Migration
Dialogue Forge v1.3.1 - Local → Cloud Migration
v1.3 introduced cloud projects and accounts, but local projects could not be moved into the cloud properly.
This update completes the migration workflow and improves cloud project management.
Local → Cloud Migration
Added migration support for existing local projects.
Users can now move projects created in local mode directly into the cloud.
New actions:
- Import Local Projects
- Import Selected
- Import All
Migration preserves:
- Graph data
- Project metadata
- Theme preferences
- Project names
No dialogue data is lost during migration.
First Login Import Flow
When signing in, Dialogue Forge now checks for existing local projects.
If local projects are found:
Users are prompted:
Local projects found.
Move them to cloud?
Options:
- Import all
- Select projects
- Skip
This allows existing users to continue seamlessly after enabling cloud accounts.
Per-Project Migration
Project cards now support:
Move to Cloud
Users can choose:
Keep local copy
or
Cloud only
This makes migrating individual projects easier without moving everything at once.
Dashboard Improvements
Improved project management experience.
Updates:
- Better Local / Cloud separation
- Immediate dashboard refresh
- Correct project counts
- Improved project state handling
Views:
All
Recent
Cloud
Local
Cloud Sync Improvements
Cloud autosave reliability improvements:
- Better sync handling
- Duplicate save prevention
- Metadata persistence
- Improved save recovery
Saved:
- Nodes
- Edges
- Metadata
- Theme
- Timestamps
This is a stability update focused on completing the cloud workflow introduced in v1.3.
Full Changelog: v1.3.0...v1.3.1
Dialogue Forge v1.3.0 - Cloud Workspace & Product Experience
Dialogue Forge v1.3.0 - Cloud Workspace & Product Experience
Dialogue Forge evolves from a local editor into a cloud-backed narrative workspace.
This release introduces accounts, cloud projects, product roadmap support, UX improvements, theme customization and a redesigned project experience.
Cloud Workspace
Projects are no longer limited to local storage.
Added:
- Google authentication
- GitHub authentication
- Cloud project storage
- Project dashboard
- Autosave workflow
- Local → cloud migration
Users can now work across devices while preserving local-first workflows.
Project Dashboard
New:
/projects
Features:
- Project cards
- Search
- Sorting
- Recent projects
- Local / Cloud separation
- Duplicate
- Delete
- Project switching
Product Roadmap
New:
/roadmap
Added a public roadmap showing:
Completed releases
Current development
Planned features
Long-term vision
Includes future milestones:
Gameplay State System
Narrative Database
Quest Systems
Collaboration
Runtime Ecosystem
AI Assistant
Template Improvements
Templates no longer require replacing the current graph.
New workflow:
Insert template
Replace project
Insert mode:
- Keeps current graph
- Preserves internal links
- Creates new Start clusters
- Prevents overlap
Added production-oriented templates:
NPC Conversation
Quest Giver
Merchant
Combat Encounter
Companion Dialogue
Tutorial
Cutscene
Multi Entry RPG
UX Cleanup
Reduced editor clutter.
Header redesign:
- Fewer icons
- Dropdown actions
- Cleaner navigation
- Compact mobile actions
Moved secondary tools into overflow menus.
Settings Redesign
Settings no longer use modal dialogs.
New fullscreen overlay:
Sections:
General
Appearance
Themes
Shortcuts
About
Editor remains mounted underneath.
Themes
Added color themes:
Default
Ocean
Forest
Midnight
Rose
Cyber
Themes affect:
Node colors
Panels
Selections
Badges
Graph accents
Saved locally and synced to account preferences.
Polish
- Pointer consistency improvements
- Navigation cleanup
- Mobile refinements
- Better template workflows
- UX improvements across editor
Dialogue Forge continues moving toward a complete narrative workflow platform.
Full Changelog: v1.2.0...v1.3.0
Dialogue Forge v1.2.0 - Mobile Support & Touch Editing
Dialogue Forge v1.2.0 - Mobile Support & Touch Editing
Dialogue Forge is now fully usable on phones and tablets.
This update brings responsive layouts, touch-first interactions, and mobile workflows while keeping the desktop experience unchanged.
Mobile & Responsive Support
Dialogue Forge now works across:
- Desktop
- Tablets
- Mobile devices
Added:
- Responsive layouts
- Mobile navigation
- Touch-friendly interactions
- Adaptive panels
Touch Graph Editing
The graph editor now supports touch interactions.
Features:
- Pinch to zoom
- Two-finger pan
- Touch node selection
- Drag & move nodes
- Double tap to open inspector
- Long press interactions
Graph editing is now usable directly from mobile devices.
Mobile Layout
Desktop keeps the original workspace layout.
Mobile introduces:
- Fullscreen canvas
- Sidebar drawer
- Bottom-sheet inspector
- Floating toolbar
- Touch node creation
Toolbar actions:
- Add node
- Search
- Preview
- Inspector
- Settings
Mobile Node Creation
Nodes can now be created without drag-and-drop.
Tap:
Add Node
Choose:
- Start
- Character
- Branch
- Trigger
- Jump
- End
Nodes appear directly in the current viewport.
Mobile Preview
Preview mode now behaves like a mobile application.
Includes:
- Fullscreen preview
- Touch-friendly branch selection
- Larger interaction areas
- Responsive entry selection
Responsive Documentation
Updated /how-to-use page.
Changes:
- Mobile TOC support
- Responsive layouts
- Better navigation on smaller screens
UX Improvements
Added:
- Drawer animations
- Bottom-sheet interactions
- Mobile transitions
- Responsive panel management
Dialogue Forge now supports creating and editing dialogue graphs from virtually any device.
Thanks to everyone testing and providing feedback.
Full Changelog: v1.1.0...v1.2.0
Dialogue Forge v1.1.0 - Entry Points & Event System Expansion
Dialogue Forge v1.1.0 - Entry Points & Event System Expansion
Major update introducing multi-entry dialogue flows, expanded event systems, and chained runtime behavior.
Added
Start Events
New Start node type for managing multiple dialogue entry points.
Examples:
- Main Story
- Merchant
- Combat
- Tutorial
- Quest chains
Features:
- Dedicated Start node type
- Multiple independent dialogue roots
- Entry selection during preview
- Separate graph branch management
- Auto-layout clustering support
Preview now allows selecting a starting branch before traversal.
Expanded Trigger Events
Trigger nodes now support categories and structured runtime events.
Categories:
Game:
- QuestStarted
- QuestCompleted
- EnemyKilled
- CutsceneStart
Variables:
- SetVariable
- AddGold
- TrustIncrease
Audio:
- PlayMusic
- StopMusic
- PlaySFX
Animation:
- Attack
- Idle
- Wave
- Sit
UI:
- OpenInventory
- ShowShop
- TutorialPopup
Custom:
- User-defined events
Triggers now include:
category
event
params
Chained Event Execution
Events can now control execution timing.
Modes:
⚡ Immediate
Execute instantly.
→ Before Next
Execute immediately before next node.
✓ After Next
Execute after next node completes.
This enables narrative sequencing and runtime chains.
Examples:
Dialogue
→ Play music
Dialogue
→ Start quest
Dialogue
→ Trigger cutscene
Updated
Preview System
Preview now supports:
- Entry point selection
- Multi-branch projects
- Trigger visualization
- Event timing visualization
- Restart branch workflow
Auto Layout
Auto-layout now treats Start nodes as graph roots.
Projects are organized into separate dialogue islands.
Example:
START Main Story
↓
Story graph
START Merchant
↓
Merchant graph
START Combat
↓
Combat graph
Inspector Improvements
Added:
- Event icons
- Category visuals
- Color-coded headers
- Trigger timing badges
Templates
Expanded template library.
Added:
- Multi Branch Story
- Combat Encounter
- Quest System
- Shop System
Templates demonstrate:
- Start nodes
- Trigger categories
- Jump events
- Chained execution
Validation
Added validation rules for:
Start nodes:
- Incoming edge detection
- Empty branches
- Isolated starts
Triggers:
- Missing category
- Missing events
- Invalid configuration
Export Format
Added support for:
- Start nodes
- Structured triggers
- Execution timing
Migration preserved for older projects.
Legacy trigger labels automatically migrate to:
category = custom
executionMode = immediate
Full Changelog: v1.0.1...v1.1.0
Dialogue Forge v1.0.1 - Branch Editor Improvements
Dialogue Forge v1.0.1 - Branch Editor Improvements
Patch release focused on dialogue authoring workflow improvements.
Fixed
- Fixed branch nodes not allowing custom branch names and player answer labels
- Users can now properly edit branch options instead of being limited to default placeholders (
Option 1,Option 2, etc.) - Improved branch option handling for preview and export workflows
Added
Character Name Suggestions
Character nodes now provide existing character names while editing.
Users can:
- Select from previously created character names
- Reuse characters more easily across dialogue graphs
- Maintain naming consistency throughout projects
- Still create entirely new character names when needed
Improvements
- Faster dialogue authoring workflow
- Better consistency when building multi-character conversations
- Improved branching dialogue usability
Dialogue Forge v1.0.0
Dialogue Forge v1.0.0 — Full Release
Dialogue Forge is a visual dialogue graph editor built for branching narrative games, RPGs, visual novels, interactive storytelling systems, and dialogue-driven experiences.
This release delivers the complete core platform with graph editing, simulation, validation, dynamic schemas, JSON import/export, and advanced UX tooling.
Visual Graph Editor
- Character nodes
- Action nodes
- Drag & drop graph editing
- Zoom and pan navigation
- Multi-select support
- Self-referencing nodes
- Cyclic graph support
- Cross-character dialogue connections
- Dialogue-option edge system
- Edge labels and metadata
- Duplicate / delete operations
Dynamic Attribute System
Nodes support fully customizable schemas.
Features:
- Add attributes dynamically
- Remove attributes
- Rename attributes
- Change attribute types
- Per-node attribute definitions
Supported types:
- Text
- Number
- Boolean
- Dropdown
- Color
- List
- Object
Example use cases:
- Emotion
- Animation
- Voice
- Sound
- Camera
- Quest Flags
- Custom gameplay metadata
Node Editing & UX
Character node support:
- Portraits
- Dialogue preview
- Emotion badges
- Metadata indicators
Action node support:
- Action type visuals
- Attribute summaries
Additional UX:
- Hover states
- Selection states
- Connection previews
- Context menus
- Keyboard shortcuts
- Copy / paste
- Undo / redo
Validation System
Graph analysis and diagnostics:
- Dead-end detection
- Orphan node detection
- Circular reference analysis
- Missing dialogue detection
- Broken edge detection
- Empty branch validation
- Visual issue highlighting
Simulation Mode
Interactive dialogue playback:
- Play graph directly
- Choice traversal
- Dialogue history
- Restart flow
- Back navigation
- Real graph execution
Import / Export
JSON system includes:
- Structured export
- Import support
- Pretty formatting
- Stable IDs
- Validation before export
Export structure:
- Characters
- Nodes
- Edges
- Schemas
Advanced Features
- Minimap
- Search
- Auto layout
- Grouping
- Branch collapsing
- Comments
- Node colors
- Favorites
- Autosave
- History support
Polish & Presentation
- Dark-first UI
- Glassmorphism styling
- Smooth animations
- Motion interactions
- Animated transitions
- Empty states
- Onboarding experience
- Example narrative project included
Tech Stack
- Next.js
- TypeScript
- React Flow
- Zustand
- Tailwind CSS
- Shadcn UI
- Framer Motion
- Zod
- React Hook Form
- dnd-kit
Dialogue Forge v1.0.0 establishes the first complete release of the platform and provides a production-ready environment for creating visual dialogue systems and branching narrative structures.