@volter/world-platform 2.0.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,29 @@
+# @volter/world-platform
+
+The Volter World platform: where people and orgs are. People sign in through one access provider,
+make orgs, add and invite members, make Worlds on the hosts the platform has enrolled, and open a
+World as themselves with a short-lived pass. It serves its own pages and never a twin; a host
+(`@volter/world-host`) serves the Worlds, and a World's pages are `@volter/world-console`.
+
+```bash
+npm install -g @volter/world-platform
+volter-platform serve --dir ./platform-state --provider oidc --url https://app.example.com
+```
+
+| Environment | For |
+|---|---|
+| `VOLTER_ISSUER`, `VOLTER_CLIENT_ID`, `VOLTER_CLIENT_SECRET` | `--provider volter` (the default without `OIDC_ISSUER`): Volter Identity keeps the people, orgs and members |
+| `OIDC_ISSUER`, `OIDC_CLIENT_ID`, `OIDC_CLIENT_SECRET`, `OIDC_NAME`, `OIDC_TRUST_EMAIL_DOMAINS` | `--provider oidc`: any OpenID Connect issuer; the platform keeps the directory |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`, `GITHUB_URL`, `GITHUB_API_URL` | `--provider github`: a GitHub OAuth app (the last two for Enterprise Server); the platform keeps the directory |
+| `RESEND_API_KEY` | the platform's mail through Resend, from `--mail-from`; without it mail is only logged |
+| `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`, `AWS_ENDPOINT_URL` | `--backup-bucket` |
+| `POLAR_ACCESS_TOKEN`, `POLAR_SERVER` | Volter's cloud only, with Volter's biller (not in this package); set without it, the platform refuses to start |
+
+The provider's client is registered with the callback `<platform>/-/sign-in/callback`. Every flag
+and name is in the [CLI reference](../../docs/reference/cli.md#volter-platform-serve). Its state is one SQLite
+database, `<dir>/platform.db`. Requires Node 22.13 or later (for `node:sqlite`) or Bun.
+
+- [Self-host the platform](../../docs/guides/self-host-the-platform.md): a host and the platform on
+  your machine, signed in through an OpenID Connect provider.
+- [The hosted product](../../docs/contributing/architecture.md#the-hosted-product): the design.
+- [Platform API](../../docs/reference/platform-api.md): every endpoint.

package/client/platform.css

@@ -0,0 +1,228 @@
+/* THE PLATFORM'S PAGES, over the kit (apps/console/client/kit/kit.css, served first): only what an org's pages show.
+   Every colour is a role of the brand, as the kit's are; dark follows the system through the brand's light-dark roles. */
+
+/* the support view's standing notice, above the top bar */
+.banner { margin: 0; border-radius: 0; border-width: 0 0 1px; text-align: center; }
+button.primary { background: var(--accent); border-color: var(--accent); color: var(--accent-ink); }
+button.primary:hover:not(:disabled) { color: var(--accent-ink); filter: brightness(1.06); }
+a.button { background: var(--surface); border-color: var(--line-strong); color: var(--ink); }
+a.button.primary { background: var(--accent); border-color: var(--accent); color: var(--accent-ink); }
+.link-button { justify-self: start; border: 0; background: none; padding: 2px 0; color: var(--ink); text-decoration: underline; text-decoration-color: var(--line-strong); text-underline-offset: 3px; }
+.link-button:hover:not(:disabled) { color: var(--ink); text-decoration-color: currentColor; }
+.mono { font-family: var(--mono); font-size: 12px; }
+.nowrap { white-space: nowrap; }
+.small { font-size: 12px; }
+.grow { flex: 1; min-width: 0; }
+.sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }
+.pre { white-space: pre-wrap; }
+.warn-text { color: var(--warn); }
+
+/* the sign-in card: the brand, one way in */
+body.portal #root { width: min(440px, 100%); }
+body.portal .card { width: 100%; }
+body.portal .card .brand h1 { font-size: 15px; margin: 0; }
+body.portal .card .brand h1 a { color: var(--ink); text-decoration: none; }
+main.boot { max-width: 520px; display: grid; gap: 14px; padding-top: 18vh; }
+
+/* the top bar: the drawer's button on a phone, the brand, where you are, search, and you */
+main.app > header { gap: 12px; }
+.search-button { margin-left: auto; display: inline-flex; align-items: center; gap: 24px; padding: 5px 8px 5px 12px; color: var(--muted); background: var(--surface-2); border-color: var(--line); min-width: 200px; justify-content: space-between; }
+.search-button:hover:not(:disabled) { color: var(--ink); border-color: var(--line-strong); }
+kbd { font: 11px/1 var(--mono); padding: 3px 5px; border: 1px solid var(--line-strong); border-radius: 4px; background: var(--surface); color: var(--muted); }
+.head-link { color: var(--muted); font-size: 13px; }
+.avatar-menu > summary { list-style: none; cursor: pointer; border-radius: 999px; }
+.avatar-menu > summary::-webkit-details-marker { display: none; }
+.avatar-menu .mark { border-radius: 999px; width: 28px; height: 28px; }
+.avatar-menu .popover { width: 240px; }
+.menu-who { display: grid; padding: 6px 10px 8px; margin-bottom: 4px; border-bottom: 1px solid var(--line); }
+.menu-list a[aria-current] { background: var(--surface-2); }
+
+/* the org switcher's popover */
+.top-picker .popover { gap: 6px; }
+.top-picker .popover input { width: 100%; }
+.top-picker .branch-list .vendor-cell { font-weight: 500; }
+.top-picker .popover > a.button { text-align: center; }
+
+/* a page: its head (title, count, actions), its lede, and a toolbar */
+.page-head { margin: 0 0 16px; }
+.page-head .content-head { margin: 0; }
+.page-head .lede { margin: 4px 0 0; color: var(--muted); max-width: 720px; }
+.count { display: inline-block; margin-left: 8px; padding: 0 8px; border-radius: 999px; background: var(--surface-2); border: 1px solid var(--line); color: var(--muted); font-size: 12px; font-weight: 600; vertical-align: middle; }
+.toolbar { display: flex; flex-wrap: wrap; gap: 8px; margin: 0 0 12px; }
+.toolbar input[type="search"], .toolbar-search { min-width: 240px; }
+.content .block { margin-bottom: 16px; overflow-x: auto; }
+.table-note { padding: 10px 14px; border-top: 1px solid var(--line); margin: 0; }
+.row-actions { display: flex; justify-content: flex-end; align-items: center; gap: 4px; }
+.marks { display: inline-flex; align-items: center; gap: 4px; }
+.marks .mode { margin-left: 6px; }
+.who { display: grid; line-height: 1.3; }
+.who a { color: var(--ink); text-decoration: none; font-weight: 600; }
+.who a:hover { text-decoration: underline; }
+.badge.ok { color: var(--ok); border-color: color-mix(in srgb, var(--ok) 40%, var(--line)); background: var(--volter-status-healthy-soft); }
+.badge.warn { color: var(--warn); border-color: var(--volter-status-attention-line); background: var(--warn-soft); }
+.badge.info { color: var(--ink); background: var(--accent-soft); border-color: var(--line-strong); }
+.badge.you { margin-left: 6px; text-transform: none; letter-spacing: 0; }
+.content td select { padding: 4px 26px 4px 8px; font-size: 13px; }
+
+/* cards */
+section.card { margin: 0 0 16px; padding: 18px 20px; }
+section.card h3 { margin: 0 0 6px; font-size: 15px; }
+section.card.flush { padding: 0; overflow: hidden; }
+.card-head { display: flex; align-items: flex-start; justify-content: space-between; gap: 16px; padding: 16px 20px; border-bottom: 1px solid var(--line); }
+.card-head h3 { margin: 0 0 2px; }
+.card-head p { margin: 0; max-width: 620px; }
+.card-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; margin-top: 12px; }
+.stack { display: grid; gap: 12px; max-width: none; margin: 0; }
+.stack label { font-size: 13px; }
+.stack > button[type="submit"] { justify-self: start; }
+.field-error { color: var(--danger-text); font-size: 12.5px; margin: -6px 0 0; }
+.stack > .mode { margin: -6px 0 0; }
+input[aria-invalid="true"] { border-color: var(--danger); }
+label.check { display: flex; align-items: flex-start; gap: 8px; color: var(--ink); font-size: 13px; }
+label.check input { margin-top: 3px; }
+.two { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
+textarea { font: inherit; font-size: 14px; padding: 8px 10px; border: 1px solid var(--line-strong); border-radius: 6px; background: var(--surface); color: var(--ink); resize: vertical; }
+.narrow { max-width: 640px; }
+
+/* a setting: what it is on the left, its control on the right */
+.setting-row { display: flex; align-items: center; justify-content: space-between; gap: 20px; padding: 14px 0; border-top: 1px solid var(--line); }
+section.card > .setting-row:first-child, section.card > p + .setting-row { border-top: 0; }
+.setting-row p { margin: 2px 0 0; }
+.setting-row.stack-row { align-items: flex-end; max-width: none; }
+.setting-row.stack-row label { display: grid; gap: 4px; color: var(--ink); }
+.settings { max-width: 820px; }
+.danger-zone { border-color: color-mix(in srgb, var(--danger) 45%, var(--line)); }
+.danger-zone h3 { color: var(--danger-text); }
+.danger-zone .setting-row { border-top: 0; padding-bottom: 0; }
+.switch { position: relative; display: inline-block; flex: none; width: 38px; height: 22px; }
+.switch input { position: absolute; inset: 0; opacity: 0; margin: 0; cursor: pointer; z-index: 1; }
+.switch span { position: absolute; inset: 0; border-radius: 999px; background: var(--volter-surface-inset); border: 1px solid var(--line-strong); transition: background var(--volter-motion-fast, 140ms); }
+.switch span::after { content: ""; position: absolute; top: 2px; left: 2px; width: 16px; height: 16px; border-radius: 999px; background: var(--surface); box-shadow: var(--volter-shadow-resting); transition: transform var(--volter-motion-fast, 140ms); }
+.switch input:checked + span { background: var(--accent); border-color: var(--accent); }
+.switch input:checked + span::after { transform: translateX(16px); background: var(--accent-ink); }
+.switch input:focus-visible + span { outline: 2px solid var(--accent); outline-offset: 2px; }
+.switch input:disabled + span { opacity: 0.5; }
+
+/* choices as cards (a token's access, a webhook's events) */
+fieldset.choice, fieldset.vendor-picker { border: 0; padding: 0; margin: 0; display: grid; gap: 8px; min-width: 0; }
+fieldset legend { font-size: 13px; color: var(--muted); padding: 0; margin-bottom: 6px; }
+.choice-card { display: flex; align-items: flex-start; gap: 10px; padding: 10px 12px; border: 1px solid var(--line); border-radius: var(--radius); cursor: pointer; color: var(--ink); }
+.choice-card.on { border-color: var(--accent); background: var(--accent-soft); }
+.choice-card input { margin-top: 3px; }
+.choice-card > span { display: grid; gap: 2px; }
+.scope-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 8px 12px; }
+.scope-grid label { display: grid; gap: 4px; color: var(--ink); }
+.scope-grid label.check { display: flex; }
+
+/* the vendor picker: what is picked as chips, the catalog as a grid of marks */
+.chips { display: flex; flex-wrap: wrap; gap: 6px; }
+.chip { display: inline-flex; align-items: center; gap: 6px; padding: 3px 8px 3px 4px; border-radius: 999px; background: var(--surface-2); border-color: var(--line); font-size: 12.5px; }
+.chip .mark { width: 18px; height: 18px; }
+.vendor-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(150px, 1fr)); gap: 6px; max-height: 280px; overflow-y: auto; padding: 2px; }
+.vendor-option { display: flex; align-items: center; gap: 8px; text-align: left; padding: 7px 10px; background: var(--surface); border-color: var(--line); }
+.vendor-option .vendor-label { flex: 1; min-width: 0; line-height: 1.25; overflow-wrap: anywhere; }
+.vendor-option[aria-pressed="true"] { border-color: var(--accent); background: var(--accent-soft); color: var(--ink); }
+.vendor-option[aria-pressed="true"]:hover:not(:disabled) { color: var(--ink); }
+
+/* invitations: an address and a role per row */
+.invite-row { display: flex; align-items: flex-end; gap: 8px; }
+.invite-row label { display: grid; gap: 4px; }
+
+/* notices: a restriction, a payment, a warning in a dialog */
+.notice { padding: 10px 14px; border-radius: var(--radius); border: 1px solid var(--line); background: var(--surface); margin: 0 0 14px; color: var(--ink); }
+.notice.ok { background: var(--volter-status-healthy-soft); border-color: color-mix(in srgb, var(--ok) 35%, var(--line)); }
+.notice.warn { background: var(--warn-soft); border-color: var(--volter-status-attention-line); }
+.notice.danger { background: var(--danger-soft); border-color: color-mix(in srgb, var(--danger) 40%, var(--line)); color: var(--ink); }
+.notice.info { background: var(--accent-soft); border-color: var(--line-strong); }
+.dialog-body .notice { margin: 0; }
+
+/* billing: the plan, the period's usage against its limits, the plans side by side */
+.billing-grid { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.4fr); gap: 16px; align-items: start; }
+.billing-grid section.card { margin: 0; }
+.eyebrow { margin: 0 0 6px; color: var(--muted); font-size: 11.5px; font-weight: 600; text-transform: uppercase; letter-spacing: 0.06em; }
+.price-line { margin: 4px 0; }
+.price { font-size: 26px; font-weight: 600; letter-spacing: -0.02em; }
+.meters { display: grid; gap: 16px; margin: 8px 0 14px; }
+.stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(130px, 1fr)); gap: 10px; margin: 0 0 8px; padding-top: 12px; border-top: 1px solid var(--line); }
+.stats dt { color: var(--muted); font-size: 12px; }
+.stats dd { margin: 0; font-weight: 600; font-variant-numeric: tabular-nums; }
+.day-bars { display: flex; align-items: flex-end; gap: 4px; height: 120px; padding-top: 8px; }
+.day-bar { flex: 1; display: grid; grid-template-rows: 1fr auto; height: 100%; align-items: end; text-align: center; }
+.day-bar span { display: block; border-radius: 3px 3px 0 0; background: var(--volter-data-base); }
+.day-bar em { font-style: normal; font-size: 10.5px; color: var(--faint); }
+.section-title { margin: 24px 0 10px; font-size: 15px; }
+.plans { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 16px; }
+.plans section.card { margin: 0; display: grid; gap: 6px; align-content: start; }
+.plans h4 { margin: 0; font-size: 15px; color: var(--ink); text-transform: none; letter-spacing: 0; }
+.plan.current { border-color: var(--accent); }
+.checks { list-style: none; padding: 0; margin: 6px 0 10px; display: grid; gap: 4px; }
+.checks li { position: relative; padding-left: 20px; }
+.checks li::before { content: "✓"; position: absolute; left: 0; color: var(--ok); font-weight: 600; }
+.plans button { justify-self: start; }
+
+/* account */
+.profile { display: flex; align-items: center; gap: 16px; }
+.profile > .mark { width: 52px; height: 52px; border-radius: 999px; font-size: 20px; }
+.profile h3 { margin: 0; }
+.profile p { margin: 2px 0 0; }
+.profile .card-actions { margin: 0; }
+.sent h3 { margin-top: 0; }
+
+/* ⌘K */
+.palette { list-style: none; padding: 0; margin: 0; display: grid; gap: 2px; max-height: 360px; overflow-y: auto; }
+.palette button { display: flex; width: 100%; justify-content: space-between; gap: 12px; border: 0; background: transparent; padding: 8px 10px; text-align: left; color: var(--ink); }
+.palette li[aria-selected="true"] button { background: var(--surface-2); }
+.palette button:hover:not(:disabled) { color: var(--ink); }
+
+/* the first run: a checklist with its progress */
+.onboarding { background: var(--surface); border: 1px solid var(--line); border-radius: var(--radius); padding: 14px 18px; margin: 0 0 16px; box-shadow: none; }
+.onboarding-head { display: flex; align-items: center; gap: 12px; }
+.onboarding-head h3 { margin: 0; font-size: 14px; }
+.progress { flex: 1; max-width: 160px; height: 6px; border-radius: 999px; background: var(--surface-2); border: 1px solid var(--line); overflow: hidden; }
+.progress span { display: block; height: 100%; background: var(--volter-status-live-base); }
+.onboarding-head .icon-button { margin-left: auto; }
+.onboarding ol { list-style: none; padding: 0; margin: 10px 0 0; display: grid; gap: 6px; }
+/* the other way through: a prompt for the person's coding agent, copied whole */
+.ask-agent { margin: 12px 0 0; border-top: 1px solid var(--line); padding-top: 10px; }
+.ask-agent > summary { list-style: none; display: flex; align-items: center; justify-content: space-between; gap: 12px; cursor: pointer; font-size: 13px; font-weight: 500; color: var(--ink); }
+.ask-agent > summary::-webkit-details-marker { display: none; }
+.ask-agent > summary > span::before { content: "\25B8"; display: inline-block; width: 1em; color: var(--muted); }
+.ask-agent[open] > summary > span::before { content: "\25BE"; }
+.ask-agent pre { margin: 10px 0 6px; white-space: pre-wrap; font-size: 12.5px; line-height: 1.55; max-width: none; }
+.ask-agent .mode { margin: 0; font-size: 12.5px; }
+.onboarding li { display: flex; align-items: center; gap: 10px; margin: 0; }
+.onboarding .tick { display: inline-grid; place-items: center; flex: none; width: 20px; height: 20px; border-radius: 999px; border: 1px solid var(--line-strong); font-size: 11px; color: var(--muted); }
+.onboarding li.done { color: var(--muted); }
+.onboarding li.done .tick { background: var(--volter-status-live-base); border-color: var(--volter-status-live-base); color: var(--volter-text-on-strong); }
+.onboarding-alt { margin: 10px 0 0 30px; font-size: 12.5px; }
+
+/* the first paint */
+main.booting .side .skeleton, main.booting .content .skeleton { border: 0; background: transparent; }
+
+/* a phone: the header keeps the menu, the brand, the place and you on one line; the sidebar is a drawer */
+@media (max-width: 900px) { .billing-grid { grid-template-columns: 1fr; } }
+@media (max-width: 720px) {
+  main.app > header { flex-wrap: nowrap; }
+  main.app > header .brand-name { display: none; }
+  main.app > header .crumbs { min-width: 0; overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
+  .search-button { min-width: 0; margin-left: auto; gap: 0; }
+  .search-button span, .search-button kbd, .head-link { display: none; }
+  .search-button::before { content: "⌕"; font-size: 16px; }
+  .two { grid-template-columns: 1fr; }
+  .toolbar-search, .toolbar input[type="search"] { min-width: 0; width: 100%; }
+  .content-head .head-actions { width: 100%; }
+  .worlds-table th:nth-child(2), .worlds-table td:nth-child(2), .worlds-table th:nth-child(3), .worlds-table td:nth-child(3), .worlds-table th:nth-child(4), .worlds-table td:nth-child(4), .tokens-table th:nth-child(3), .tokens-table td:nth-child(3), .tokens-table th:nth-child(5), .tokens-table td:nth-child(5), .pending-table th:nth-child(3), .pending-table td:nth-child(3) { display: none; }
+  .profile { flex-wrap: wrap; }
+  .setting-row { flex-wrap: wrap; }
+}
+
+/* the Worlds empty state: Create World beside the sample, and the sample's note on its own line */
+.actions-row { display: flex; flex-wrap: wrap; justify-content: center; gap: 8px; }
+.empty-body .sample-note { display: block; margin-top: 8px; font-size: 12.5px; }
+
+/* a World's pull-request previews, under its row */
+.preview-row td { padding-top: 0; padding-bottom: 10px; border-top: 0; }
+.preview-row td > .mode { font-size: 12px; margin-right: 10px; }
+.previews { display: inline-flex; flex-wrap: wrap; gap: 6px 16px; list-style: none; margin: 0; padding: 0; vertical-align: middle; }
+.previews li { display: inline-flex; align-items: center; gap: 8px; font-size: 13px; }
+.worlds-table tr:has(+ .preview-row) td { border-bottom: 0; }