Feat: Add Docker setup, CMake and cross-platform build scripts

.devcontainer/entrypoint.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Source emsdk environment
+if [ -f "${EMSDK_ROOT}/emsdk_env.sh" ]; then
+  source "${EMSDK_ROOT}/emsdk_env.sh"
+fi
+
+# Go to workdir
+cd /usr/src/app
+
+exec "$@"

.dockerignore

@@ -0,0 +1,8 @@
+node_modules/*
+dist/*
+build/*
+docs/build/*
+.vscode
+.git
+.gitignore
+.DS_Store

.editorconfig

@@ -25,10 +25,25 @@ insert_final_newline = true
 max_line_length = 120
 
 # -------------------------
-# Makefile
+# CMake
 # -------------------------
-[Makefile]
-indent_style = tab
+[CMakeLists.txt]
+indent_style = space
+indent_size = 2
+charset = utf-8
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+max_line_length = 120
+
+[*.cmake]
+indent_style = space
+indent_size = 2
+charset = utf-8
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+max_line_length = 120
 
 # -------------------------
 # JavaScript / React
@@ -130,3 +145,48 @@ max_line_length = off
 [LICENSE]
 max_line_length = off
 trim_trailing_whitespace = false
+
+# -------------------------
+# Bash / Shell scripts
+# -------------------------
+[*.{sh,bash}]
+indent_style = space
+indent_size = 2
+charset = utf-8
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+max_line_length = 120
+# img2num is in bash
+[img2num]
+indent_style = space
+indent_size = 2
+charset = utf-8
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+max_line_length = 120
+
+# -------------------------
+# Batch scripts
+# -------------------------
+[*.{bat,cmd}]
+indent_style = space
+indent_size = 2
+charset = utf-8
+end_of_line = crlf
+trim_trailing_whitespace = true
+insert_final_newline = true
+max_line_length = 120
+
+# -------------------------
+# PowerShell scripts
+# -------------------------
+[*.ps1]
+indent_style = space
+indent_size = 2
+charset = utf-8
+end_of_line = crlf
+trim_trailing_whitespace = true
+insert_final_newline = true
+max_line_length = 120

.gitignore

@@ -27,3 +27,8 @@ dist-ssr
 *:Zone.Identifier
 
 src/data/contributor-credits.json
+
+# CMake build artifacts
+src/wasm/cmake-build/
+src/wasm/**/CMakeCache.txt
+src/wasm/**/CMakeFiles/

Dockerfile.dev

@@ -0,0 +1,42 @@
+# ------------------------
+# Img2Num Dockerfile.dev
+# ------------------------
+FROM node:22-bullseye
+
+ENV EMSDK_VERSION=4.0.10
+ENV EMSDK_DIR=/opt/emsdk
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+      build-essential \
+      cmake \
+      python3 \
+      git \
+      curl \
+      unzip \
+      pkg-config \
+      bash \
+      ca-certificates \
+      libvips-dev \
+      && rm -rf /var/lib/apt/lists/*
+
+# Install EMSDK once, cached by Docker layers
+RUN git clone --depth 1 https://github.com/emscripten-core/emsdk.git $EMSDK_DIR \
+&& cd $EMSDK_DIR \
+&& git fetch --tags \
+&& git checkout $EMSDK_VERSION \
+&& ./emsdk install $EMSDK_VERSION \
+&& ./emsdk activate $EMSDK_VERSION
+
+ENV PATH=$EMSDK_DIR:$EMSDK_DIR/upstream/emscripten:$PATH
+ENV EMSDK=$EMSDK_DIR
+
+RUN npm install -g npm@11
+
+WORKDIR /usr/src/app
+
+ENV CHOKIDAR_USEPOLLING=true
+ENV CHOKIDAR_INTERVAL=100
+
+EXPOSE 5173 3000
+
+CMD ["bash"]

README.md

@@ -1,5 +1,4 @@
-<!--TODO: Remove the section below after #93 is merged on 22 Dec 2025-->
-
+<!--TODO: Remove the section below after #139 (which replaced #93) is merged on 22 Dec 2025 - wait 2 weeks, so remove this on 5 Jan 2026 -->
 > [!CAUTION]
 > ⚠️⚠️⚠️ **Breaking Change in [PR #93](https://github.com/Ryan-Millard/Img2Num/pull/93)** ⚠️⚠️⚠️
 >

docker-compose.yml

@@ -0,0 +1,25 @@
+services:
+  dev:
+    image: ryanmillard/img2num-dev:latest
+    build:
+      context: .
+      dockerfile: Dockerfile.dev
+    container_name: img2num-dev
+    working_dir: /usr/src/app
+    volumes:
+      - .:/usr/src/app:cached
+      - node_modules:/usr/src/app/node_modules
+      - docs_node_modules:/usr/src/app/docs/node_modules
+    environment:
+      CHOKIDAR_USEPOLLING: "true"
+      CHOKIDAR_INTERVAL: "100"
+    ports:
+      - "5173:5173" # Vite dev
+      - "4173:4173" # Vite preview
+      - "3000:3000" # Docusaurus dev
+    stdin_open: true
+    tty: true
+
+volumes:
+  node_modules:
+  docs_node_modules:

docs/docs/guidelines/CONTRIBUTING.md

@@ -32,7 +32,7 @@ The [Project Scripts](../project-scripts/overview.md) section shows all of the a
 ## Additional Resources
 
 - [README](https://github.com/Ryan-Millard/Img2Num/blob/main/README.md)
-- [Orchestrator Makefile](https://github.com/Ryan-Millard/Img2Num/blob/main/src/wasm/Makefile)
+- [Orchestrator CMakeLists.txt](https://github.com/Ryan-Millard/Img2Num/blob/main/src/wasm/CMakeLists.txt)
 - [Vite Config](https://github.com/Ryan-Millard/Img2Num/blob/main/vite.config.js)
 - [ESLint Config](https://github.com/Ryan-Millard/Img2Num/blob/main/eslint.config.js)
 

docs/docs/guidelines/coding-style.md

@@ -6,7 +6,7 @@ sidebar_position: 3
 
 ## 🌐General Rules
 - **Follow `.editorconfig`** exactly:
-  - Indent: **2 spaces** (except Makefile: tabs)
+  - Indent: **2 spaces**
   - Charset: **UTF-8**
   - Line endings: **LF**
   - Max line length: 120 (off for JSON, Markdown, lock files, images)
@@ -93,9 +93,6 @@ namespace exampleNamespace
 - Final newline: true (lock files: false)
 - Max line length: off
 
-## 📝 Makefiles
-- Indent: **tabs only**
-
 ## 🖼 Images / Binary Assets
 - Charset: binary
 - Do not trim trailing whitespace

docs/docs/index.md

@@ -10,38 +10,33 @@ Img2Num is a lightweight, high-performance C++ library (compiled to WebAssembly)
 
 Whether you're a beginner or an advanced user, you'll find everything you need here to get started and master Img2Num.
 
----
-
 ## Features
 
 - ⚡ **Fast & Efficient**: Optimized for large images.
 - 🖼️ **Image to Numeric Conversion**: Seamlessly convert images to arrays.
 - 🌐 **WebAssembly Ready**: Run directly in the browser.
 - 🔧 **Developer-Friendly**: Easy-to-use API for rapid integration.
 
----
-
 ## Getting Started
 
-1. **Installation**
-   Follow the [installation guide](./introduction/getting-started.md) to set up Img2Num quickly.
-
-2. **Usage Examples**
-   Learn how to process images with our [code examples](./).
-
-3. **Advanced Topics**
-   Explore performance tips, SIMD intrinsics, and optimization tricks in [advanced guides](./).
-
----
+Follow the [installation guide](./introduction/getting-started.md) to set up Img2Num quickly.
 
 ## Quick Links
 
 - [Overview](./introduction/getting-started.md) – Project introduction and setup
 - [Changelog](/changelog) – Track releases and updates
-- [Examples](./) – Ready-to-use snippets and demos
-- [FAQ](./) – Common questions answered
 
 ---
 
-Enjoy using **Img2Num**!
-For issues or contributions, visit our [GitHub repository](https://github.com/Ryan-Millard/Img2Num).
+We hope you enjoy using **Img2Num**!
+For issues or contributions, visit our
+[GitHub repository](https://github.com/Ryan-Millard/Img2Num/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22good%20first%20issue%22).
+
+:::important
+If you spot something wrong in the documentation or elsewhere, please help the community by opening an issue for it!
+
+Issue links:
+- [Bug Report](https://github.com/Ryan-Millard/Img2Num/issues/new?template=bug_report.yml)
+- [Refactor / Code Quality Improvement](https://github.com/Ryan-Millard/Img2Num/issues/new?template=refactor.yml)
+- [Blank Issue](https://github.com/Ryan-Millard/Img2Num/issues/new)
+:::