docs: setup documentation with Rspress (#208)

* docs: init

* add confguration, getting started and remote cache

* update getting-started

* add intro

* show name instead of logo for now

* update PackageManagerTabs and fix workspace

* small tweaks

* use proper arrow

* add docs for commands

* update cli and configuration

* use PackageManagerTabs

* fix image

* deploy config

* fix: update package managers

* fix: update package manager in root too

* fix: build command

* fix: add `outDir`

* feat: add analytics

* update docs

* set pnpm version in action

---------

Co-authored-by: szymonrybczak <[email protected]>

Author: thymikee

.github/actions/setup-node/action.yml

@@ -6,7 +6,7 @@ runs:
   steps:
     - uses: pnpm/action-setup@v4
       with:
-        version: 10.2.1+sha256.f988f0d93b87e1da2d8cdf6ac7f45a01c6f843ae3606b4ca0f2ffd713b85f975
+        version: 10.2.1
 
       # Cache node_modules
     - uses: actions/setup-node@v4

package.json

@@ -59,5 +59,5 @@
   "nx": {
     "includedScripts": []
   },
-  "packageManager": "[email protected]+sha256.f988f0d93b87e1da2d8cdf6ac7f45a01c6f843ae3606b4ca0f2ffd713b85f975"
+  "packageManager": "[email protected]"
 }

packages/platform-apple-helpers/src/lib/commands/build/buildOptions.ts

@@ -10,8 +10,6 @@ export type BuildFlags = {
   extraParams?: string[];
   exportExtraParams?: string[];
   exportOptionsPlist?: string;
-  device?: string;
-  catalyst?: boolean;
   buildFolder?: string;
   destination?: string;
   destinations?: string[];
@@ -58,15 +56,6 @@ export const getBuildOptions = ({ platformName }: BuilderCommand) => {
       name: '--export-options-plist <string>',
       description: 'Name of the export options file for archiving. Defaults to: ExportOptions.plist',
     },
-    {
-      name: '--device <string>',
-      description:
-        'Explicitly set the device or simulator to use by name or by UDID.',
-    },
-    {
-      name: '--catalyst',
-      description: 'Run on Mac Catalyst.',
-    },
     {
       name: '--build-folder <string>',
       description: `Location for ${readableName} build artifacts. Corresponds to Xcode's "-derivedDataPath".`,

packages/platform-apple-helpers/src/lib/commands/build/buildProject.ts

@@ -106,7 +106,7 @@ export const buildProject = async ({
       }
     }
 
-    if (args.device) {
+    if ('device' in args && args.device) {
       // Check if the device argument looks like a UDID (assuming UDIDs are alphanumeric and have specific length)
       const isUDID = /^[A-Fa-f0-9-]{25,}$/.test(args.device);
       if (isUDID) {
@@ -117,7 +117,7 @@ export const buildProject = async ({
       }
     }
 
-    if (args.catalyst) {
+    if ('catalyst' in args && args.catalyst) {
       return ['platform=macOS,variant=Mac Catalyst'];
     }
 

packages/platform-apple-helpers/src/lib/commands/run/runOptions.ts

@@ -6,6 +6,8 @@ export interface RunFlags extends BuildFlags {
   binaryPath?: string;
   port: string;
   remoteCache?: boolean;
+  device?: string;
+  catalyst?: boolean;
 }
 
 export const getRunOptions = ({ platformName }: BuilderCommand) => {
@@ -23,6 +25,15 @@ export const getRunOptions = ({ platformName }: BuilderCommand) => {
       name: '--no-remote-cache',
       description: 'Do not use remote build caching.',
     },
+    {
+      name: '--device <string>',
+      description:
+        'Explicitly set the device or simulator to use by name or by UDID.',
+    },
+    {
+      name: '--catalyst',
+      description: 'Run on Mac Catalyst.',
+    },
     ...getBuildOptions({ platformName }),
   ];
 };