[green] Correct pre-activation public claims

Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>

Author: yyods

.github/ISSUE_TEMPLATE/bug.yml

@@ -31,10 +31,61 @@ body:
     validations:
       required: true
   - type: input
-    id: hardware
+    id: profile
     attributes:
-      label: Hardware and platform
-      description: Exact board/profile and iPadOS, Android, browser, or desktop version
+      label: Exact installer profile ID
+      description: For installer problems, use the exact profile ID shown on /flash; otherwise enter "Not installer-related."
+    validations:
+      required: true
+  - type: input
+    id: module
+    attributes:
+      label: Exact board model and module marking
+      description: Copy the board model and the text printed on the module; enter "Not applicable" only when no board is involved.
+    validations:
+      required: true
+  - type: input
+    id: memory
+    attributes:
+      label: Memory configuration
+      description: Flash capacity, PSRAM capacity, and PSRAM type (Octal, Quad, none, or unknown).
+    validations:
+      required: true
+  - type: input
+    id: browser
+    attributes:
+      label: Browser
+      description: Browser name and exact version; enter "Not applicable" when the browser is not involved.
+    validations:
+      required: true
+  - type: input
+    id: operating_system
+    attributes:
+      label: Desktop operating system
+      description: Desktop operating system and exact version; enter "Not applicable" when the installer is not involved.
+    validations:
+      required: true
+  - type: input
+    id: installer_stage
+    attributes:
+      label: Failed installer stage
+      description: For example page load, browser check, profile selection, artifact verification, port selection, erase, write, verification, first boot, or recovery; otherwise enter "Not installer-related."
+    validations:
+      required: true
+  - type: input
+    id: tablet
+    attributes:
+      label: Exact tablet or device model
+      description: Name the iPad or Android device used with the app; enter "Not applicable" only when the app is not involved.
+    validations:
+      required: true
+  - type: input
+    id: tablet_os
+    attributes:
+      label: Tablet operating system
+      description: Tablet operating system and exact version (iPadOS or Android); enter "Not applicable" only when the app is not involved.
+    validations:
+      required: true
   - type: textarea
     id: steps
     attributes:

README.md

@@ -13,7 +13,7 @@ compatible microcontroller board over Bluetooth Low Energy. Its normal
 workflow needs no USB serial connection, Wi-Fi onboarding, cloud account, or
 telemetry.
 
-- Website and browser installer: [pyble.dev](https://pyble.dev)
+- Website and browser-installer status: [pyble.dev](https://pyble.dev)
 - iPad external beta:
   [join with TestFlight](https://testflight.apple.com/join/yU4e8s6d)
 - License: [MIT](LICENSE)
@@ -27,7 +27,7 @@ telemetry.
 </p>
 
 <p align="center">
-  <em>Actual PyBLE app: a GPIO 48 NeoPixel Blocks program and its generated MicroPython on the pictured ESP32-S3 board.</em>
+  <em>Actual PyBLE app in landscape: GPIO 48 NeoPixel Blocks beside the generated MicroPython.</em>
 </p>
 
 ## What works
@@ -62,16 +62,17 @@ BLE GATT peripheral. It supports:
 - board naming and identify support; and
 - upstream MicroPython’s standard `neopixel` module.
 
-The public browser installer currently offers qualified images for:
+The public browser installer is currently unavailable pending v0.4.2 HIL on
+both exact current profiles:
 
-| Installer profile | Typical target                     | Availability                                |
-| ----------------- | ---------------------------------- | ------------------------------------------- |
-| `esp32-4mb`       | Classic ESP32, 4 MB flash          | Available                                   |
-| `esp32-s3-n16r8`  | ESP32-S3, 16 MB flash / 8 MB PSRAM | Available                                   |
-| `esp32-c3-4mb`    | ESP32-C3, 4 MB flash               | Source target; public installer pending HIL |
+| Installer profile | Exact target constraint                                      | Public status                                       |
+| ----------------- | ------------------------------------------------------------ | --------------------------------------------------- |
+| `esp32-4mb`       | Classic ESP32, 4 MiB external SPI flash; no PSRAM assumed     | v0.4.2 HIL pending; installer unavailable           |
+| `esp32-s3-n16r8`  | ESP32-S3, 16 MiB flash / 8 MiB Octal PSRAM; N16R8-class only | v0.4.2 HIL pending; installer unavailable           |
+| `esp32-c3-4mb`    | ESP32-C3, 4 MiB external SPI flash; no PSRAM assumed          | Planned; no public image; exact-profile HIL pending |
 
-These are the initial validated ports, not a chip-family allowlist. A future
-board is compatible when it has a maintained PyBLE agent port, BLE GATT
+These are the initial port targets, not a chip-family allowlist. A future board
+is compatible when it has a maintained PyBLE agent port, BLE GATT
 peripheral support, adequate resources, PBLE/1 conformance, recovery testing,
 and hardware-validation evidence. Stock MicroPython plus generic Bluetooth
 hardware is not sufficient by itself.
@@ -102,14 +103,17 @@ shared conformance corpus, documentation, and CI atomically.
 
 ## Try PyBLE
 
-1. Open [pyble.dev/flash](https://pyble.dev/flash) in desktop Chrome or Edge.
-2. Select the exact supported profile for your board and flash the qualified
-   agent firmware. Flashing erases the board; review the installer warning and
-   back up files first.
-3. Install the iPad beta from
+1. Install the iPad beta from
    [TestFlight](https://testflight.apple.com/join/yU4e8s6d), or build the
    Flutter app locally.
-4. Open PyBLE, scan for the board, connect, and run an example.
+2. Check [pyble.dev/flash](https://pyble.dev/flash) in desktop Chrome or Edge.
+   The public installer is currently unavailable pending v0.4.2 HIL. Wait for
+   that page to show an active release version, your exact profile, and an
+   enabled install action.
+3. Only after that gate opens, back up the board, confirm its exact memory
+   profile, and use the one-time wired installer. Flashing erases the board.
+4. Open PyBLE, scan for the provisioned board, connect, and run an example over
+   BLE.
 
 See [support and troubleshooting](https://pyble.dev/support) for browser,
 Bluetooth, and recovery requirements.

tools/web/public/social/pyble-beta-og-1200x630.png

@@ -999,7 +999,7 @@ h3 {
 .target-grid > div {
   display: flex;
   min-width: 0;
-  min-height: 190px;
+  min-height: 275px;
   padding: 25px 17px;
   align-items: center;
   justify-content: flex-end;
@@ -1062,19 +1062,39 @@ h3 {
 
 .target-grid strong {
   color: var(--white);
-  font-size: 0.95rem;
+  font-family: "SFMono-Regular", Consolas, "Liberation Mono", monospace;
+  font-size: 0.78rem;
 }
 
 .target-grid small {
   color: #899db6;
   font-size: 0.68rem;
 }
 
+.target-grid__target-name {
+  margin-top: 6px;
+  color: #dceaff;
+  font-size: 0.78rem;
+  font-weight: 700;
+}
+
+.target-grid__constraint {
+  margin-top: 10px;
+  line-height: 1.45;
+}
+
+.target-grid .target-grid__status {
+  margin-top: 9px;
+  color: var(--warning);
+  font-weight: 700;
+  line-height: 1.4;
+}
+
 .target-grid > .target-grid__target--planned {
   border-style: dashed;
 }
 
-.target-grid__target--planned small {
+.target-grid__target--planned .target-grid__status {
   color: var(--warning);
 }
 

tools/web/public/social/pyble-beta-og-1200x630.svg

@@ -57,7 +57,7 @@ const steps = [
   {
     number: "01",
     title: "Provision once",
-    body: "Install matching PyBLE-enabled MicroPython firmware once. Initial beta images are available for compatible ESP32 targets.",
+    body: "After v0.4.2 passes HIL, use USB once to install the exact matching PyBLE-enabled MicroPython profile. The public installer is unavailable during qualification.",
   },
   {
     number: "02",
@@ -87,10 +87,11 @@ export default function HomePage() {
             <h1>Code your MicroPython board. Leave the cable behind.</h1>
             <p className="hero__lede">
               PyBLE is a free, tablet-first IDE designed for boards that run
-              MicroPython and support Bluetooth Low Energy. The current firmware
-              release supports qualified classic ESP32 and ESP32-S3 module
-              profiles. ESP32-C3 and more microcontroller families remain
-              planned.
+              MicroPython and support Bluetooth Low Energy. Public v0.4.2
+              firmware is pending HIL for the exact esp32-4mb and esp32-s3-n16r8
+              profiles. The public browser installer stays unavailable until
+              both exact profiles pass HIL. ESP32-C3 and more microcontroller
+              families remain planned.
             </p>
             <div className="button-row">
               <Link className="button button--primary" href="#testflight">
@@ -248,20 +249,26 @@ export default function HomePage() {
               {initialFirmwareTargets.map((target) => (
                 <div
                   className={
-                    target.availability === "Planned profile"
+                    target.planned
                       ? "target-grid__target target-grid__target--planned"
                       : "target-grid__target"
                   }
-                  key={target.name}
+                  key={target.id}
                 >
                   <span className="target-grid__chip" aria-hidden="true">
                     <i />
                     <i />
                     <i />
                     <i />
                   </span>
-                  <strong>{target.name}</strong>
-                  <small>{target.availability}</small>
+                  <strong>{target.id}</strong>
+                  <span className="target-grid__target-name">
+                    {target.target}
+                  </span>
+                  <small className="target-grid__constraint">
+                    {target.constraint}
+                  </small>
+                  <small className="target-grid__status">{target.status}</small>
                 </div>
               ))}
             </div>
@@ -339,9 +346,10 @@ export default function HomePage() {
             <p className="eyebrow">External testing is open</p>
             <h2 id="testflight-title">Join the PyBLE beta on TestFlight.</h2>
             <p className="beta-invite__lede">
-              Install the free iPad beta through Apple TestFlight. Then use
-              desktop Chrome to provision a supported board and start coding
-              over Bluetooth Low Energy.
+              Install the free iPad beta through Apple TestFlight now. Public
+              board provisioning will open only after v0.4.2 passes HIL on both
+              exact release profiles; after that one-time USB setup, everyday
+              coding runs over Bluetooth Low Energy.
             </p>
             <div className="button-row beta-invite__actions">
               <a
@@ -354,7 +362,7 @@ export default function HomePage() {
                 <ArrowIcon />
               </a>
               <Link className="button button--secondary" href="/flash">
-                Install board firmware
+                Check firmware status
               </Link>
             </div>
           </div>

tools/web/src/app/globals.css

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 // Part of PyBLE (https://pyble.dev) — see /LICENSE.
 
-import { MailIcon } from "@/components/icons";
+import { ExternalIcon, MailIcon } from "@/components/icons";
 import { PageIntro } from "@/components/page-intro";
 import { pageMetadata, siteConfig } from "@/lib/site";
 
@@ -13,11 +13,15 @@ export const metadata = pageMetadata({
 });
 
 const diagnosticItems = [
-  "Board and chip family",
+  "Exact installer profile ID (or “not installer-related”)",
+  "Exact board model and module marking",
+  "Flash capacity, PSRAM capacity, and PSRAM type",
+  "Browser name/version and desktop OS name/version",
+  "Failed installer stage and redacted error text",
+  "Exact tablet or device model",
+  "Tablet OS: iPadOS or Android name/version",
   "PyBLE app and agent versions",
-  "iPadOS or Android version",
   "The exact steps that caused the problem",
-  "Relevant console text and a screenshot",
 ] as const;
 
 export default function SupportPage() {
@@ -38,12 +42,12 @@ export default function SupportPage() {
               <li>
                 <span>1</span>
                 <div>
-                  <h3>Install the matching firmware once</h3>
+                  <h3>Check firmware status before installing</h3>
                   <p>
-                    The public installer supports only esp32-4mb and
-                    esp32-s3-n16r8. ESP32-C3 is not currently available. Use the
-                    reviewed image supplied for your exact target; this initial
-                    step uses a cable.
+                    The public installer is unavailable while v0.4.2 HIL runs
+                    for esp32-4mb and esp32-s3-n16r8. ESP32-C3 is not currently
+                    available. Wait for the installer status to show an active
+                    release and enabled action; this initial step uses a cable.
                   </p>
                 </div>
               </li>
@@ -139,21 +143,29 @@ export default function SupportPage() {
         <aside className="report-card">
           <MailIcon />
           <p className="eyebrow">Send a useful report</p>
-          <h2>Include these five things</h2>
+          <h2>Include these exact details</h2>
           <ul>
             {diagnosticItems.map((item) => (
               <li key={item}>{item}</li>
             ))}
           </ul>
           <a
             className="button button--primary"
-            href={`mailto:${siteConfig.supportEmail}`}
+            href={siteConfig.bugReportUrl}
+            target="_blank"
+            rel="noopener noreferrer"
           >
-            {siteConfig.supportEmail}
+            Open the GitHub bug template
+            <ExternalIcon />
           </a>
           <p className="fine-print">
             Please remove Wi-Fi passwords, access tokens, and other private data
-            from screenshots or code before sending.
+            and personal identifiers from screenshots or code before sending.
+            For a private, non-security support question, email{" "}
+            <a href={`mailto:${siteConfig.supportEmail}`}>
+              {siteConfig.supportEmail}
+            </a>
+            .
           </p>
         </aside>
       </div>