update package commands with rimraf for cross platform compatibility and added additional info on readme how to do first time setup and tests

Author: matas-bitbybit-dev

README.md

@@ -87,5 +87,59 @@ Bit By Bit Developers company will keep these core algorithms that you can find
 ## About Bit By Bit Developers platform
 Bit By Bit Developers web platform allows creators to program geometry through simple visual programming language or choose monaco typescript editor with full intellisense of bitbybit API. This cloud platform can fulfil many practical, educational and artistic needs of its users. Through familiar programming interface used in tools such as Scratch and Blockly.Games we expose powerful 3D algorithms that make it easier to implement various parametric tasks. Our goal is to make it very simple for users to share their ideas and designs. We want to encourage everyone to engage in the future of this tool.
 
+# Development Setup
+
+## First Time Setup and Testing
+
+For first-time developers working on this project, follow these steps to set up the development environment and run all unit tests:
+
+### Prerequisites
+- Node.js (v16 or higher recommended)
+- npm (comes with Node.js)
+- Git
+
+### Quick Start
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/bitbybit-dev/bitbybit.git
+   cd bitbybit
+   ```
+
+2. Run the complete first-time setup (this will install all dependencies, build all packages, and run all unit tests):
+   ```bash
+   npm run first-time-setup
+   ```
+
+### Available Commands
+
+- `npm run first-time-setup` - Complete setup for new developers (installs dependencies, builds packages, runs tests)
+- `npm run setup` - Install dependencies and build all packages without running tests
+- `npm run setup-and-test` - Install dependencies, build packages, and run all unit tests
+- `npm run test` - Run all unit tests (requires packages to be built first)
+- `npm run ci-packages` - Install dependencies for all packages
+- `npm run build-packages` - Build all packages
+- `npm run rebuild-all-packages` - Clean and rebuild all packages
+
+### Cross-Platform Compatibility
+All commands are now cross-platform compatible and work on Windows, macOS, and Linux. The project uses:
+- `rimraf` for cross-platform file deletion
+- Standard npm scripts for package management
+
+### Running Individual Package Tests
+You can also run tests for individual packages:
+- `npm run test-base` - Test base package
+- `npm run test-occt` - Test OCCT package  
+- `npm run test-core` - Test core package
+- `npm run test-jscad` - Test JSCAD package
+- `npm run test-manifold` - Test Manifold package
+- `npm run test-threejs` - Test ThreeJS package
+
+### Troubleshooting
+If you encounter issues during setup:
+1. Make sure you have Node.js v16+ installed
+2. Clear npm cache: `npm cache clean --force`
+3. Delete node_modules and package-lock.json, then run `npm install`
+4. If on Windows, make sure to run commands in a proper terminal (Command Prompt, PowerShell, or WSL)
+
 ## Major Dependencies
 BabylonJS, ThreeJS, OpenCascade, Manifold, JSCAD, Verbnurbs

package.json

@@ -15,16 +15,16 @@
         "ci-manifold-worker": "cd packages/dev/manifold-worker && npm ci",
         "ci-manifold": "cd packages/dev/manifold && npm ci",
         "ci-packages": "npm run ci-base && npm run ci-core && npm run ci-threejs && npm run ci-babylonjs && npm run ci-occt-worker && npm run ci-occt && npm run ci-jscad-worker && npm run ci-jscad && npm run ci-manifold-worker && npm run ci-manifold",
-        "rm-dist-base-if-exists": "rm -rf packages/dev/base/dist || true",
-        "rm-dist-core-if-exists": "rm -rf packages/dev/core/dist || true",
-        "rm-dist-threejs-if-exists": "rm -rf packages/dev/threejs/dist || true",
-        "rm-dist-babylonjs-if-exists": "rm -rf packages/dev/babylonjs/dist || true",
-        "rm-dist-occt-worker-if-exists": "rm -rf packages/dev/occt-worker/dist || true",
-        "rm-dist-occt-if-exists": "rm -rf packages/dev/occt/dist || true",
-        "rm-dist-jscad-worker-if-exists": "rm -rf packages/dev/jscad-worker/dist || true",
-        "rm-dist-jscad-if-exists": "rm -rf packages/dev/jscad/dist || true",
-        "rm-dist-manifold-worker-if-exists": "rm -rf packages/dev/manifold-worker/dist || true",
-        "rm-dist-manifold-if-exists": "rm -rf packages/dev/manifold/dist || true",
+        "rm-dist-base-if-exists": "rimraf packages/dev/base/dist",
+        "rm-dist-core-if-exists": "rimraf packages/dev/core/dist",
+        "rm-dist-threejs-if-exists": "rimraf packages/dev/threejs/dist",
+        "rm-dist-babylonjs-if-exists": "rimraf packages/dev/babylonjs/dist",
+        "rm-dist-occt-worker-if-exists": "rimraf packages/dev/occt-worker/dist",
+        "rm-dist-occt-if-exists": "rimraf packages/dev/occt/dist",
+        "rm-dist-jscad-worker-if-exists": "rimraf packages/dev/jscad-worker/dist",
+        "rm-dist-jscad-if-exists": "rimraf packages/dev/jscad/dist",
+        "rm-dist-manifold-worker-if-exists": "rimraf packages/dev/manifold-worker/dist",
+        "rm-dist-manifold-if-exists": "rimraf packages/dev/manifold/dist",
         "rm-dist-packages": "npm run rm-dist-base-if-exists && npm run rm-dist-core-if-exists && npm run rm-dist-threejs-if-exists && npm run rm-dist-babylonjs-if-exists && npm run rm-dist-occt-worker-if-exists && npm run rm-dist-occt-if-exists && npm run rm-dist-jscad-worker-if-exists && npm run rm-dist-jscad-if-exists && npm run rm-dist-manifold-worker-if-exists && npm run rm-dist-manifold-if-exists",
         "build-base": "cd packages/dev/base && npm run build-p",
         "build-core": "cd packages/dev/core && npm run build-p",
@@ -45,7 +45,10 @@
         "test-jscad": "cd packages/dev/jscad && npm run test-c",
         "test-manifold": "cd packages/dev/manifold && npm run test-c",
         "test-threejs": "cd packages/dev/threejs && npm run test-c",
-        "test": "npm run test-occt && npm run test-base && npm run test-core && npm run test-jscad && npm run test-manifold && npm run test-threejs"
+        "test": "npm run test-occt && npm run test-base && npm run test-core && npm run test-jscad && npm run test-manifold && npm run test-threejs",
+        "setup": "npm run install-rebuild-all-packages",
+        "setup-and-test": "npm run setup && npm run test",
+        "first-time-setup": "npm install && npm run setup-and-test"
     },
     "repository": {
         "type": "git",
@@ -70,6 +73,7 @@
     },
     "homepage": "https://bitbybit.dev",
     "devDependencies": {
-        "typescript": "^4.3.5"
+        "typescript": "^4.3.5",
+        "rimraf": "^5.0.5"
     }
 }