appv2

FoundryVTT V13 ApplicationV2 Development Guide

FoundryVTT V13 introduces ApplicationV2 — a complete rewrite of the application layer. It replaces jQuery with plain DOM, introduces declarative actions, template parts, and a new tab system. All new development should use ApplicationV2.

Class Hierarchy

Choose the right base class for your use case:

ApplicationV2 (Base)           -> Configuration dialogs, custom tools
+-- DocumentSheetV2            -> Journal entries, other documents
|   +-- ActorSheetV2           -> Actor character sheets (auto drag/drop)
|   +-- ItemSheetV2            -> Item editing sheets
+-- DialogV2                   -> User prompts, confirmations

Quick Reference

// For actor sheets
const { HandlebarsApplicationMixin } = foundry.applications.api
const { ActorSheetV2 } = foundry.applications.sheets
class MyActorSheet extends HandlebarsApplicationMixin(ActorSheetV2) { }

// For item sheets
const { ItemSheetV2 } = foundry.applications.sheets
class MyItemSheet extends HandlebarsApplicationMixin(ItemSheetV2) { }

// For configuration dialogs
const { ApplicationV2, HandlebarsApplicationMixin } = foundry.applications.api
class MyConfigDialog extends HandlebarsApplicationMixin(ApplicationV2) { }

// For user prompts
class MyPrompt extends DialogV2 { }

HandlebarsApplicationMixin

Always mix in HandlebarsApplicationMixin for template rendering. It provides the PARTS system and Handlebars template support.

const { HandlebarsApplicationMixin } = foundry.applications.api
class MySheet extends HandlebarsApplicationMixin(ActorSheetV2) { }

DEFAULT_OPTIONS

Replaces defaultOptions getter. Defined as a static property:

static DEFAULT_OPTIONS = {
  classes: ['my-system', 'sheet', 'actor'],
  position: {
    width: 600,
    height: 600
  },
  window: {
    resizable: true,
    title: 'MY_SYSTEM.SheetTitle'  // Localization key
  },
  actions: {
    rollAbilityCheck: this.#rollAbilityCheck,
    itemCreate: this.#itemCreate,
    itemDelete: this.#itemDelete
  }
}