GoFrame v0.2.0-preview.1

Release Notes: v0.2.0-preview.1

Summary

v0.2.0-preview.1 is a narrow evaluator preview for GoFrame's web-first direction.

This release records the post-v0.1.0-preview.2 work around external Go component package evidence and closes the public strategy wording around GoFrame's active direction: browser/WASM runtime, GOX, goxc, package/export workflows, examples, and CI evidence.

GoFrame remains experimental. This release does not claim production readiness, stable 1.0 APIs, fullstack/server APIs, SSR/hydration, Player/Engine, .gfapp, or a broad reusable package ecosystem.

Highlights

• Web-first positioning closeout: GoFrame is described as an experimental Go-first web application framework and toolchain.
• Player/Engine, .gfapp, portable host/runtime packaging, desktop/mobile shells, and custom app engine work are inactive and outside the preview promise.
• External component package identity evidence now covers:
  • package-qualified GOX tags for external imports;
  • import aliases as debug labels rather than runtime identity;
  • same-symbol package separation;
  • versioned import path separation.
• goxc build workspaces now preserve app module require / replace directives needed for ordinary Go package resolution.
• Local relative replace targets are rewritten to original module locations when materialized under .goframe/work/<profile>.
• Go/WASM build-flow evidence covers a local-replace external Go component package imported by an app module.
• Release-facing docs keep preview promises tied to current evidence.

Supported In This Preview

This preview supports evaluating:

• browser/WASM interactive apps;
• the current pkg/goframe runtime surfaces documented as public-candidate or experimental;
• GOX generation, package-qualified component tags, and diagnostics covered by current tests;
• goxc generate, build, package, export, serve, size, clean, doctor, and version;
• static package/export workflow for browser deployment artifacts;
• hash-router/static-host deployment model;
• app module local require / replace external Go component package path for ordinary Go packages.

Not Supported / Not Claimed

This release does not claim:

• production readiness;
• stable 1.0 API compatibility;
• fullstack/server APIs;
• SSR or hydration;
• history-mode router, file routing, route loaders, or production server fallback automation;
• production static server behavior in goxc serve;
• raw .gox generation inside external dependencies;
• broad reusable component package ecosystem stability;
• full multi-module monorepo support;
• remote or non-local external module evidence for the new external component package path;
• equivalent Firefox or Safari support;
• Player/Engine, .gfapp, portable host/runtime packaging, desktop/mobile shells, or custom app engine;
• stable LSP/formatter behavior.

Install

go install github.com/graybuton/goframe/cmd/goxc@v0.2.0-preview.1

Full Notes

See docs/release-notes-v0.2.0-preview.1.md for the complete release notes, validation scope, platform evidence, upgrade notes, and known limitations.