v0.2.0 Release Notes¶

Release Date: 2026-04-26

This release introduces a principal-based identity model, a full dashboard template marketplace, and multi-app deployment support.

Highlights¶

Principal-based Identity - Unified identity root for all actor types (human, application, agent, service) with CoreForge integration
Dashboard Marketplace - Complete marketplace for dashboard templates with licensing, subscriptions, and seat management
Multi-app Deployment - Run DashForge as part of a larger CoreForge multi-app platform

New Features¶

Principal Identity Model¶

The new principal-based identity system replaces direct User references with a flexible model supporting multiple actor types:

Principal - Unified identity root with type discrimination
Human - Human-specific attributes (email, profile)
PrincipalMembership - Organization membership management

// Example: Creating a human principal
principal := client.Principal.Create().
    SetType("human").
    SetIdentifier("user@example.com").
    SetDisplayName("John Doe").
    SetOrganizationID(orgID).
    SaveX(ctx)

Dashboard Marketplace¶

New entities enable a complete marketplace workflow:

Entity	Purpose
`Publisher`	Organizations that create and sell templates
`Listing`	Marketplace entries for templates/connectors
`License`	Purchased access to marketplace items
`Subscription`	Recurring license subscriptions
`SeatAssignment`	Per-seat license allocation
`DashboardTemplate`	Reusable dashboard templates

Authorization Enhancements¶

Publisher and consumer role hierarchies
Marketplace-specific permissions (publish, purchase, review)
SpiceDB integration for fine-grained access control

Multi-app Backend¶

DashForge can now run in both standalone and multi-app modes:

// Multi-app deployment
import "github.com/plexusone/dashforge/multiapp"

server.RegisterApp(multiapp.NewBackend(nil))

Breaking Changes¶

None. This release is backward compatible with v0.1.0.

Migration Guide¶

From v0.1.0¶

Run database migrations to add new tables
Existing User records continue to work
Optionally migrate to Principal model for new features

# Run migrations
dashforge migrate up

Dependencies¶

Package	Version	Change
`entgo.io/ent`	v0.14.6	Updated
`github.com/grokify/coreforge`	v0.6.0	Updated
`github.com/go-chi/chi/v5`	v5.2.5	Added
`github.com/jackc/pgx/v5`	v5.9.2	Added
`github.com/lib/pq`	v1.12.3	Updated
`golang.org/x/oauth2`	v0.36.0	Updated