docs: update developer portal docs

Author: kabaros

docs/_sidebar.md

@@ -1,4 +1,5 @@
 -   [**Getting Started**](getting-started)
+-   -   [Initialize a new web application](commands/create-app)
 -   **Commands**
 -   -   [`d2`](commands/d2)
 -   -   [`d2 cluster`](commands/d2-cluster)

docs/commands/create-app.md

@@ -0,0 +1,30 @@
+---
+title: Create a new app
+sidebar_label: Create new app
+id: create-app
+slug: '/cli/create-app'
+---
+
+# @dhis2/create-app
+
+This package publishes a package that follows the convention of [npm create](https://docs.npmjs.com/cli/v11/commands/npm-init#synopsis).
+
+This allows users to create a new DHIS2 web application by running the command:
+
+```sh
+# with pnpm
+pnpm create @dhis2/app project-name --yes
+#
+```
+
+```sh
+# with npm
+npx @dhis2/create-app --yes
+# or npm create @dhis2/app -- --yes
+```
+
+By passing `--yes` argument, this will create a new DHIS2 web application using the default options without prompting (using `pnpm` as a package manager, and `TypeScript` as the language).
+
+If you omit the `--yes` argument `pnpm create @dhis2/app project-name` then you will be prompted and guided through a wizard to choose your options.
+
+You can run the commands in `debug` mode to get more verbose logs by passing the `--debug` option (`pnpm create @dhis2/app project-name --debug`).

docs/getting-started.md

@@ -20,6 +20,18 @@ npm install --global @dhis2/cli
 d2 --version
 ```
 
+## Initialize a new web app
+
+If you are only interested in scaffolding a new web app you can bypass installing the whole CLI, and make use of [npm create](https://docs.npmjs.com/cli/v11/commands/npm-init) convention:
+
+```sh
+# with pnpm
+pnpm create @dhis2/app project-name --yes
+#
+```
+
+This will create a new DHIS2 web application. Check the documentation for [@dhis2/create-app](./commands/create-app.md) for more information.
+
 ## Ad-hoc usage
 
 You can also run the CLI ad-hoc with `npx`, no installation necessary (sacrifices startup performance). So only do this if you've got a good use case for it. In most cases you'll want to install it globally.

packages/create-app/README.md

@@ -12,8 +12,8 @@ pnpm create @dhis2/app project-name --yes
 
 ```sh
 # with npm
-npm create @dhis2/app -- --yes
-# or npx @dhis2/create-app --yes
+npx @dhis2/create-app --yes
+# npm create @dhis2/app -- --yes
 ```
 
 By passing `--yes` argument, this will create a new DHIS2 web application using the default options without prompting (using `pnpm` as a package manager, and `TypeScript` as the language).