{"title":"Beta Support","description":"Supported platforms and feature boundaries for Amber 2.0.0-beta.5","section":"","version":"v2","path":"beta-support","canonical_url":"https://amberframework.org/docs/v2/beta-support","markdown_url":"https://amberframework.org/docs/v2/beta-support.md","inherited":false,"content_markdown":"# Amber V2 Beta Support\n\n**Status checked August 13, 2026.** Amber Framework `2.0.0-beta.5` and Amber\nCLI `2.0.6` are the coordinated database-backed web beta. Amber `1.5.0`\nremains the stable framework line.\n\n“Beta” describes the V2 framework release, not an expectation that ordinary\nweb applications will be repeatedly rewritten. The supported path includes\nrouting, controllers, ECR, typed configuration, request schemas, Grant ORM,\nMicrate migrations, SQLite, WebSockets, jobs, mailer, local CSS, and\nbrowser-native modules. The release gate includes fingerprinted CSS,\nJavaScript, images, fonts, SRI, caching, and compression. Generated\nauthentication, generated API resources, Gemma attachments, and native\napplications keep separate preview boundaries.\n\n## What each platform signal means\n\n- **Web compile** means CI built Amber CLI, generated the database-backed web\n  app, installed dependencies, generated the Pet scaffold, applied its test\n  migration, ran specs, and compiled the application.\n- **Install artifact** means the current CLI release publishes a ready-to-use\n  archive or Homebrew package for that target.\n- **Release-gated** means the supported installation, generation, dependency,\n  migration, spec, build, launch, HTML form, create, update, and static-asset\n  sequence must pass before release.\n\nOne signal does not silently imply the others.\n\n## Platform matrix\n\n| Platform | Database-backed web compile | CLI 2.0.6 install artifact | Beta release gate |\n|---|---|---|---|\n| Apple Silicon macOS | Verified | Homebrew and `darwin-arm64` archive | Yes |\n| x86-64 Linux | Verified | Homebrew or `linux-x86_64` archive | Yes |\n| ARM64 Linux | Verified on GitHub-hosted ARM64 Linux | `linux-arm64` archive | Yes |\n| Windows x86-64 | Verified in GitHub Actions | None | No |\n| Intel macOS | Not currently verified | None | No |\n\nThe [Amber CLI 2.0.6 pull request](https://github.com/amberframework/amber_cli/pull/38)\nis the current platform evidence stream. Windows installs the SQLite native library,\nbuilds the CLI, generates the same Grant application, applies the test\nmigration, runs its specs, and compiles the executable. It remains outside the\nrelease gate only because CLI `2.0.6` does not publish a Windows archive.\n\n## Application and generator matrix\n\n| Command or surface | Status |\n|---|---|\n| `amber new APP --type web` | Supported; ECR, Grant, and SQLite default |\n| homepage, fingerprinted CSS/JS/images/fonts, SRI, caching, compression | Release-gated |\n| `amber assets build` and `amber assets check` | Supported and release-gated |\n| `amber generate model` | Supported; Grant model, spec, and migration |\n| `amber generate scaffold` | Supported; model, schema, HTML CRUD, ECR views, specs, route, migration |\n| `amber generate migration` | Supported; Micrate Up/Down SQL |\n| `amber database` | Supported; create, drop, migrate, status, version, rollback, redo, seed |\n| controller, schema, job, mailer, channel generators | Supported |\n| `amber generate api` and `amber generate auth` | Preview |\n| `amber new APP --type native` | Preview |\n| Grant guides | Supported default web model layer |\n| Asset Pipeline guides | Supported web path |\n| Gemma guides | Preview ecosystem material |\n\n“Preview” means code can be evaluated, but it is not part of the web release\ngate and may require additional design or production review. Preview does not\nmean that the entire framework or a generated web application is unstable.\n\n## Persistence contract\n\nA generated web application contains:\n\n- Grant pinned to the reviewed V2 commit;\n- exactly one selected driver: SQLite, PostgreSQL, or MySQL;\n- `config/database.cr` registering the `primary` connection;\n- separate development, test, and production database URLs;\n- Micrate inside the compiled CLI rather than as a second app command;\n- model and scaffold generators that write reversible SQL under\n  `db/migrations/`.\n\nThe release smoke test uses SQLite and exercises a real create and update\nthrough the generated ECR forms. This proves the default integration, not every\nquery, database feature, or production topology. PostgreSQL and MySQL users\nmust test against the server versions they deploy.\n\n## Versions\n\n- Amber V2 framework beta: `2.0.0-beta.5` — published August 13, 2026\n- Amber CLI: `2.0.6` — published August 13, 2026\n- Asset Pipeline: `0.37.0` — published August 12, 2026\n- Grant: reviewed commit pinned by Amber CLI `2.0.6`\n- Micrate: `0.16.0-beta.1`, embedded and pinned by Amber CLI `2.0.6`\n- Amber stable framework: `1.5.0` — published August 1, 2026\n- Crystal: `>= 1.20.0, < 2.0`\n\nGenerated applications pin the framework prerelease exactly. Do not replace it\nwith `v2-dev`, `master`, or a personal Amber fork when following the supported\npath. See the human-readable [release notes](/releases), the\n[Pet Tracker](guides/pet-tracker/) acceptance journey, and the\n[V1-to-V2 migration guide](migration-guide/) for the smallest safe upgrade."}