@nocobase/cli 2.1.0-beta.44 → 2.1.0-beta.44.test.2

package/LICENSE

@@ -0,0 +1,201 @@
+                                 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

@@ -1,416 +1,99 @@
-# NocoBase CLI
+# NocoBase
 
-NocoBase CLI (`nb`) is a command-line tool for setting up and managing NocoBase
-apps in a local workspace. It helps you connect coding agents to NocoBase by
-preparing the app, saving the CLI env config, and providing day-to-day commands
-for start, stop, logs, upgrade, and cleanup.
+<video width="100%" controls>
+  <source src="https://github.com/user-attachments/assets/4d11a87b-00e2-48f3-9bf7-389d21072d13" type="video/mp4">
+</video>
 
-The CLI supports two common setup paths:
+<p align="center">
+<a href="https://trendshift.io/repositories/4112" target="_blank"><img src="https://trendshift.io/api/badge/repositories/4112" alt="nocobase%2Fnocobase | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+<a href="https://www.producthunt.com/posts/nocobase?embed=true&utm_source=badge-top-post-topic-badge&utm_medium=badge&utm_souce=badge-nocobase" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-topic-badge.svg?post_id=456520&theme=light&period=weekly&topic_id=267" alt="NocoBase - Scalability&#0045;first&#0044;&#0032;open&#0045;source&#0032;no&#0045;code&#0032;platform | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
+</p>
 
-- Connect an existing NocoBase app so coding agents can use it.
-- Install a new NocoBase app from Docker, npm, or Git, then connect it as a CLI env.
+## What is NocoBase
 
-## Prerequisites
+NocoBase is the most extensible AI-powered no-code platform.   
+Total control. Infinite extensibility. AI collaboration.  
+Enable your team to adapt quickly and cut costs dramatically.  
+No years of development. No millions wasted.  
+Deploy NocoBase in minutes — and take control of everything.
 
-- Node.js v20+
-- Yarn 1.x
-- Git, required when installing from Git source
-- Docker, required when installing with Docker or using the built-in database
+Homepage:  
+https://www.nocobase.com/  
 
-## Installation
-
-Install the CLI globally:
-
-```bash
-npm install -g @nocobase/cli@alpha
-```
-
-Check the available commands:
-
-```bash
-nb --help
-nb init --help
-```
-
-## Core Concepts
-
-- **Workspace**: the current project folder where `.nocobase` is stored.
-- **Env**: a named NocoBase connection saved by the CLI. In `nb init`, the app name is also the env name.
-- **Source**: how the local app is obtained. Supported values are `docker`, `npm`, and `git`.
-- **Remote env**: an env that only stores an API connection to an existing NocoBase app.
-- **Runtime resources**: local app process, Docker app container, built-in database container, source directory, and storage directory managed by CLI commands.
-
-## Quick Start
-
-### Guided Setup
-
-Run the guided terminal flow:
-
-```bash
-nb init
-```
-
-Use the browser-based setup form:
-
-```bash
-nb init --ui
-```
-
-`nb init` can either connect to an existing NocoBase app or install a new one.
-When creating a new app, it can also install NocoBase AI coding skills
-(`nocobase/skills`) globally.
-
-Use `--skip-skills` if the skills are managed separately, or when running in CI
-or offline environments where `nb init` should not install them.
-
-### Non-Interactive Setup
-
-When prompts are skipped, an app/env name is required:
-
-```bash
-nb init --env app1 --yes
-nb init --env app1 --yes --skip-skills
-```
-
-Install with Docker:
-
-```bash
-nb init --env app1 --yes --source docker --version alpha
-```
-
-Install from npm:
-
-```bash
-nb init --env app1 --yes --source npm --version alpha --app-port 13080
-```
-
-Install from Git source:
-
-```bash
-nb init --env app1 --yes --source git --version alpha
-```
-
-For Git source installs, `--version alpha` resolves to the `develop` branch.
-
-Install from a Git branch:
-
-```bash
-nb init --env app1 --yes --source git --version fix/cli-v2
-```
-
-`--version` is the shared version input across sources:
-
-- npm: package version
-- Docker: image tag
-- Git: git ref such as a branch or tag
-
-By default, a new local app uses:
-
-- Source directory: `./<envName>/source/`
-- Storage directory: `./<envName>/storage/`
-
-### Resume an Interrupted Setup
-
-If `nb init` was interrupted after the env config had already been saved, you can continue the same setup:
-
-```bash
-nb init --env app1 --resume
-nb init --env app1 --resume --skip-skills
-```
-
-`--resume` reuses the saved workspace env config for app, source, database, and env connection settings. In interactive mode, it only asks for any missing setup-only values.
-
-In non-interactive resume mode, `nb init --resume --yes` uses default initialization values unless these flags are passed explicitly:
-
-- `--lang`
-- `--root-username`
-- `--root-email`
-- `--root-password`
-- `--root-nickname`
-
-## Daily Commands
-
-| Command | Description |
-| --- | --- |
-| `nb init` | Set up NocoBase and connect it as a CLI env for coding agents. |
-| `nb app` | Manage app runtimes: start, stop, restart, logs, cleanup, and upgrades. |
-| `nb source` | Manage the local source project: download, develop, build, and test. |
-| `nb db` | Inspect or manage built-in database runtime status for local envs. |
-| `nb env` | Manage saved CLI env connections. |
-| `nb api` | Call NocoBase API resources from the CLI. |
-| `nb plugin` | Manage plugins for the selected NocoBase env. |
-| `nb self` | Check or update the installed NocoBase CLI. |
-| `nb skills` | Check, install, or update global NocoBase AI coding skills. |
-
-Recommended style: pass the env name explicitly when operating on a specific env. Runtime commands accept `--env`, and `nb env info` also accepts a positional env name:
-
-```bash
-nb app start --env app1
-nb app restart --env app1
-nb app logs --env app1
-nb env info app1
-nb db ps --env app1
-```
-
-Equivalent shorthand examples:
-
-```bash
-nb app start -e app1
-nb app restart -e app1
-nb app logs -e app1
-nb app upgrade -e app1
-nb db start -e app1
-```
-
-## CLI And Skills Updates
+Online Demo:  
+https://demo.nocobase.com/new
 
-Check whether the installed CLI itself is up to date:
+Documents:  
+https://docs.nocobase.com/
 
-```bash
-nb self check
-nb self check --json
-```
+Forum:  
+https://forum.nocobase.com/
 
-Update the CLI when it is installed globally with npm:
+Use Cases:  
+https://www.nocobase.com/en/blog/tags/customer-stories
 
-```bash
-nb self update
-```
+## Release Notes
 
-Check whether the global NocoBase AI coding skills are installed:
+Our [blog](https://www.nocobase.com/en/blog/timeline) is regularly updated with release notes and provides a weekly summary.
 
-```bash
-nb skills check
-nb skills check --json
-```
+## Distinctive features
 
-Install the skills for the first time, or update an existing `nocobase/skills` install:
+### 1. Data model-driven, not form/table–driven
 
-```bash
-nb skills install
-nb skills update
-```
+Instead of being constrained by forms or tables, NocoBase adopts a data model–driven approach, separating data structure from user interface to unlock unlimited possibilities.
 
-## Runtime Types
+- UI and data structure are fully decoupled
+- Multiple blocks and actions can be created for the same table or record in any quantity or form
+- Supports the main database, external databases, and third-party APIs as data sources
 
-### Docker
+![model](https://static-docs.nocobase.com/model.png)
 
-Docker envs are managed through saved Docker containers and images:
+### 2. AI employees, integrated into your business systems
+Unlike standalone AI demos, NocoBase allows you to embed AI capabilities seamlessly into your interfaces, workflows, and data context, making AI truly useful in real business scenarios.
 
-```bash
-nb init --env app1 --yes --source docker --version alpha
-nb app start --env app1
-nb app restart --env app1
-nb app logs --env app1
-nb app stop --env app1
-```
+- Define AI employees for roles such as translator, analyst, researcher, or assistant
+- Seamless AI–human collaboration in interfaces and workflows
+- Ensure AI usage is secure, transparent, and customizable for your business needs
 
-Docker downloads support platform selection:
+![AI-employee](https://static-docs.nocobase.com/ai-employee-home.png)
 
-```bash
-nb source download --source docker --version alpha --docker-platform auto
-nb source download --source docker --version alpha --docker-platform linux/amd64
-nb source download --source docker --version alpha --docker-platform linux/arm64
-```
+### 3. What you see is what you get, incredibly easy to use
 
-### npm and Git
+While enabling the development of complex business systems, NocoBase keeps the experience simple and intuitive.
 
-npm and Git envs use a local source directory and can run development mode:
+- One-click switch between usage mode and configuration mode
+- Pages serve as a canvas to arrange blocks and actions, similar to Notion
+- Configuration mode is designed for ordinary users, not just programmers
 
-```bash
-nb init --env app1 --yes --source git --version alpha
-nb source dev --env app1
-```
+![wysiwyg](https://static-docs.nocobase.com/wysiwyg.gif)
 
-`nb source dev` only supports npm/Git source envs. Docker envs can be inspected with
-`nb app logs`, and remote envs only support API/env operations.
+### 4. Everything is a plugin, designed for extension
+Adding more no-code features will never cover every business case. NocoBase is built for extension through its plugin-based microkernel architecture.
 
-### Existing NocoBase App
+- All functionalities are plugins, similar to WordPress
+- Plugins are ready to use upon installation
+- Pages, blocks, actions, APIs, and data sources can all be extended through custom plugins
 
-To connect an existing app, use `nb init` and choose the existing-app setup
-path, or add the env directly:
+![plugins](https://static-docs.nocobase.com/plugins.png)
 
-```bash
-nb env add app1 --api-base-url http://localhost:13000/api
-```
-
-`nb env add` will start the authentication flow automatically when needed.
-
-## Upgrade
-
-Upgrade refreshes the saved source or image, then restarts the app:
-
-```bash
-nb app upgrade --env app1
-```
-
-Use `--skip-code-update` or `-s` to restart with the saved local code or Docker
-image without downloading updates first:
-
-```bash
-nb app upgrade --env app1 -s
-```
-
-## Database Commands
-
-Use `nb db` to inspect or manage the built-in database runtime for a local env:
-
-```bash
-nb db ps
-nb db ps --env app1
-nb db start --env app1
-nb db stop --env app1
-nb db logs --env app1
-```
-
-Notes:
-
-- `nb db start` can also recreate the saved built-in database container when it has been removed.
-- `nb db start` and `nb db stop` only work for envs created with the built-in database option enabled.
-- `nb db logs` only works for envs created with the built-in database option enabled.
-- `nb db ps` can also show `external` or `remote` status for envs that do not have a CLI-managed database container.
-
-## Cleanup
-
-Stop only the app runtime:
-
-```bash
-nb app stop --env app1
-```
-
-Stop the app runtime and also remove the CLI-managed built-in database runtime when present:
-
-```bash
-nb app stop --env app1 --with-db
-```
-
-- `nb app stop` keeps storage data and the saved CLI env config.
-- Docker envs remove the saved app container when stopped.
-- `--with-db` only affects CLI-managed built-in databases. External databases are not touched.
-
-Destroy the env's managed local resources:
-
-```bash
-nb app destroy --env app1
-nb app destroy --env app1 --force
-```
-
-- `nb app destroy` removes managed runtime resources, storage data, and the saved CLI env config.
-- For downloaded npm/Git envs, `nb app destroy` also removes the saved local app files. Custom local app directories are kept.
-- In interactive terminals, `nb app destroy` requires a strong confirmation prompt. In non-interactive mode, re-run with `--env <name> --force`.
-- `nb app down` is deprecated. Use `nb app stop --with-db` for runtime cleanup, or `nb app destroy` for destructive cleanup.
-
-## Environment Management
-
-Show the current env:
-
-```bash
-nb env
-```
-
-Show only the current env name:
-
-```bash
-nb env current
-```
-
-Set up shell session integration for `NB_SESSION_ID`:
-
-```bash
-nb session setup
-nb session id
-nb session remove
-```
-
-List configured envs with token-verified API status:
-
-```bash
-nb env list
-```
-
-Show details for one env:
-
-```bash
-nb env info app1
-```
-
-Switch the current env:
-
-```bash
-nb env use app1
-```
-
-Re-authenticate an env when credentials need to be refreshed:
-
-```bash
-nb env auth app1
-```
-
-Update runtime command metadata from the selected app:
-
-```bash
-nb env update app1
-```
-
-## API Commands
-
-The CLI can call NocoBase resources through the configured env:
-
-```bash
-nb api resource list --resource users -e app1
-nb api resource get --resource users --filter-by-tk 1 -e app1
-nb api resource create --resource users --values '{"nickname":"Ada"}' -e app1
-```
-
-Create and download a backup:
-
-```bash
-nb api backup create -e app1
-nb api backup status --name backup_20260430_120000_1234.nbdata -e app1
-nb api backup download --name backup_20260430_120000_1234.nbdata --output ./backup.nbdata -e app1
-```
-
-Restore or run a migration package:
+## Installation
 
-```bash
-nb api backup restore-upload --file ./backup.nbdata -e app1
-nb api migration rules create --name default --user-defined-rule schema-only --system-defined-rule overwrite-first -e app1
-nb api migration create --rule-id 1 --title release-20260430 -e app1
-nb api migration execute --file ./migration.nbdata -e app1
-```
+NocoBase supports three installation methods:
 
-Use `-j, --json-output` to print raw JSON when available:
+- <a target="_blank" href="https://docs.nocobase.com/welcome/getting-started/installation/docker-compose">Installing With Docker (👍Recommended)</a>
 
-```bash
-nb api resource list --resource users -e app1 -j
-```
+  Suitable for no-code scenarios, no code to write. When upgrading, just download the latest image and reboot.
 
-Available API command topics:
+- <a target="_blank" href="https://docs.nocobase.com/welcome/getting-started/installation/create-nocobase-app">Installing from create-nocobase-app CLI</a>
 
-| Command | Description |
-| --- | --- |
-| `nb api acl` | Manage access control based on roles, resources, and actions. |
-| `nb api api-keys` | Manage API keys for HTTP API access. |
-| `nb api app` | Manage application resources. |
-| `nb api authenticators` | Manage user authentication, including password auth, SMS auth, SSO protocols, and extensible providers. |
-| `nb api backup` | Create, download, remove, and restore backups. |
-| `nb api data-modeling` | Manage data sources, collections, and database modeling resources. |
-| `nb api file-manager` | Manage file storage services, file collections, and attachment fields. |
-| `nb api flow-surfaces` | Compose and mutate page, tab, block, field, and action surfaces. |
-| `nb api migration` | Create, check, execute, and inspect migration packages. |
-| `nb api pm` | Manage plugins through API commands. |
-| `nb api resource` | Work with generic collection resources. |
-| `nb api system-settings` | Adjust system title, logo, language, and other global settings. |
-| `nb api theme-editor` | Customize UI colors and dimensions, save themes, and switch between them. |
-| `nb api workflow` | Manage workflow resources for business automation. |
+  The business code of the project is completely independent and supports low-code development.
 
-## Local Data
+- <a target="_blank" href="https://docs.nocobase.com/welcome/getting-started/installation/git-clone">Installing from Git source code</a>
 
-The CLI stores workspace-level config in `.nocobase`:
+  If you want to experience the latest unreleased version, or want to participate in the contribution, you need to make changes and debug on the source code, it is recommended to choose this installation method, which requires a high level of development skills, and if the code has been updated, you can git pull the latest code.
 
-- `config.json`: env definitions, current env, and workspace-level settings.
-- `versions/<version>/commands.json`: cached runtime commands generated from the target app.
+## How NocoBase works
 
-Runtime data such as source files, storage files, Docker containers, and
-database data are managed separately according to the env source and install
-options.
+<video width="100%" controls>
+  <source src="https://github.com/user-attachments/assets/8d183b44-9bb5-4792-b08f-bc08fe8dfaaf" type="video/mp4">
+</video>