Adding React example

examples/C/react/GNUmakefile

@@ -0,0 +1,141 @@
+# WebUI C Example
+
+# == 1. VARIABLES =============================================================
+
+MAKEFILE_PATH := $(abspath $(lastword $(MAKEFILE_LIST)))
+PROJECT_DIR := $(dir $(MAKEFILE_PATH))/../../../
+TARGET := $(firstword $(MAKECMDGOALS))
+LIB_DIR := $(PROJECT_DIR)/dist
+ifeq ($(TARGET), debug)
+LIB_DIR := $(LIB_DIR)/debug
+endif
+INCLUDE_DIR := $(PROJECT_DIR)/include
+WEBUI_LIB_NAME = webui-2
+ifeq ($(WEBUI_USE_TLS), 1)
+WEBUI_LIB_NAME = webui-2-secure
+endif
+
+# ARGS
+# Set a compiler when running on Linux via `make CC=gcc` / `make CC=clang`
+CC = gcc
+# Build the WebUI library if running via `make BUILD_LIB=true`
+BUILD_LIB ?=
+
+# BUILD FLAGS
+STATIC_BUILD_FLAGS = main.c -I"$(INCLUDE_DIR)" -L"$(LIB_DIR)"
+DYN_BUILD_FLAGS = main.c -I"$(INCLUDE_DIR)" -L"$(LIB_DIR)"
+
+# Platform conditions
+ifeq ($(OS),Windows_NT)
+	# Windows
+	PLATFORM := windows
+	SHELL := CMD
+	STATIC_BUILD_FLAGS += -l$(WEBUI_LIB_NAME)-static -lws2_32 -Wall -luser32 -static
+	COPY_LIB_CMD := @copy "$(LIB_DIR)\$(WEBUI_LIB_NAME).dll" "$(WEBUI_LIB_NAME).dll"
+	DYN_BUILD_FLAGS += "$(WEBUI_LIB_NAME).dll" -lws2_32 -Wall -luser32
+	STATIC_OUT := main.exe
+	DYN_OUT := main-dyn.exe
+	LWS2_OPT := -lws2_32 -lOle32
+	STRIP_OPT := --strip-all
+	CONSOLE_APP := -Wl,-subsystem=console
+	GUI_APP := -Wl,-subsystem=windows
+else
+	STATIC_BUILD_FLAGS += -lpthread -lm -l$(WEBUI_LIB_NAME)-static
+	DYN_BUILD_FLAGS += -lpthread -lm
+	STATIC_OUT := main
+	DYN_OUT := main-dyn
+	ifeq ($(shell uname),Darwin)
+		# MacOS
+		PLATFORM := macos
+		CC = clang
+		COPY_LIB_CMD := @cp "$(LIB_DIR)/$(WEBUI_LIB_NAME).dylib" "$(WEBUI_LIB_NAME).dylib"
+		DYN_BUILD_FLAGS += "./$(WEBUI_LIB_NAME).dylib"
+		WKWEBKIT_LINK_FLAGS := -framework Cocoa -framework WebKit
+	else
+		# Linux
+		PLATFORM := linux
+		COPY_LIB_CMD := @cp "$(LIB_DIR)/$(WEBUI_LIB_NAME).so" "$(WEBUI_LIB_NAME).so"
+		STATIC_BUILD_FLAGS += -ldl
+		DYN_BUILD_FLAGS += -ldl "./$(WEBUI_LIB_NAME).so"
+		STRIP_OPT := --strip-all
+		ifeq ($(CC),clang)
+			LLVM_OPT := llvm-
+		endif
+	endif
+endif
+
+# == 2.TARGETS ================================================================
+
+all: release
+
+debug: --validate-args
+ifeq ($(BUILD_LIB),true)
+	@cd "$(PROJECT_DIR)" && $(MAKE) debug
+endif
+#	Static with Debug info
+ifneq ($(WEBUI_USE_TLS), 1)
+	@echo "Build C Example ($(CC) debug static)..."
+	@$(CC) -g $(CONSOLE_APP) $(STATIC_BUILD_FLAGS) $(LWS2_OPT) $(WKWEBKIT_LINK_FLAGS) -o $(STATIC_OUT)
+endif
+#	Dynamic with Debug info
+	@echo "Build C Example ($(CC) debug dynamic)..."
+	$(COPY_LIB_CMD)
+	@$(CC) -g $(CONSOLE_APP) $(DYN_BUILD_FLAGS) $(LWS2_OPT) $(WKWEBKIT_LINK_FLAGS) -o $(DYN_OUT)
+#	Clean
+ifeq ($(PLATFORM),windows)
+	@- del *.o >nul 2>&1
+else
+	@- rm -f *.o
+	@- rm -rf *.dSYM # macOS
+endif
+	@echo "Done."
+
+release: --validate-args
+ifeq ($(BUILD_LIB),true)
+	@cd "$(PROJECT_DIR)" && $(MAKE)
+endif
+#	Static Release
+ifneq ($(WEBUI_USE_TLS), 1)
+	@echo "Build C Example ($(CC) release static)..."
+	@$(CC) -Os $(GUI_APP) $(STATIC_BUILD_FLAGS) $(LWS2_OPT) $(WKWEBKIT_LINK_FLAGS) -o $(STATIC_OUT)
+	@$(LLVM_OPT)strip $(STRIP_OPT) $(STATIC_OUT)
+endif
+#	Dynamic Release
+	@echo "Build C Example ($(CC) release dynamic)..."
+	$(COPY_LIB_CMD)
+	@$(CC) $(GUI_APP) $(DYN_BUILD_FLAGS) $(LWS2_OPT) $(WKWEBKIT_LINK_FLAGS) -o $(DYN_OUT)
+	@$(LLVM_OPT)strip $(STRIP_OPT) $(DYN_OUT)
+#	Clean
+ifeq ($(PLATFORM),windows)
+	@- del *.o >nul 2>&1
+else
+	@- rm -f *.o
+	@- rm -rf *.dSYM # macOS
+endif
+	@echo "Done."
+
+clean: --clean-$(PLATFORM)
+
+# INTERNAL TARGETS
+
+--validate-args:
+ifneq ($(filter $(CC),gcc clang aarch64-linux-gnu-gcc arm-linux-gnueabihf-gcc musl-gcc),$(CC))
+$(error Invalid compiler specified: `$(CC)`)
+endif
+
+--clean-linux: --clean-unix
+
+--clean-macos: --clean-unix
+
+--clean-unix:
+	- rm -f *.o
+	- rm -f *.a
+	- rm -f *.so
+	- rm -f *.dylib
+	- rm -rf *.dSYM
+
+--clean-windows:
+	- del *.o >nul 2>&1
+	- del *.dll >nul 2>&1
+	- del *.a >nul 2>&1
+	- del *.exe >nul 2>&1

examples/C/react/Makefile

@@ -0,0 +1,64 @@
+# WebUI C Example
+# Windows - Microsoft Visual C
+
+SHELL = CMD
+LIB_DIR = ../../../dist
+INCLUDE_DIR = ../../../include
+WEBUI_LIB_NAME = webui-2
+!IF "$(WEBUI_USE_TLS)" == "1"
+WEBUI_LIB_NAME = webui-2-secure
+!ENDIF
+
+# Build the WebUI library if running `nmake BUILD_LIB=true`
+BUILD_LIB =
+
+all: release
+
+debug:
+!IF "$(BUILD_LIB)" == "true"
+	@cd "$(LIB_DIR)" && cd .. && $(MAKE) debug
+!ENDIF
+#	Static with Debug info
+!IF "$(WEBUI_USE_TLS)" != "1"
+	@echo Build C Example (Static Debug)...
+	@cl /Zi main.c /I"$(INCLUDE_DIR)" /link /LIBPATH:"$(LIB_DIR)\debug" /SUBSYSTEM:CONSOLE $(WEBUI_LIB_NAME)-static.lib user32.lib Advapi32.lib Shell32.lib Ole32.lib /OUT:main.exe 1>NUL 2>&1
+!ENDIF
+#	Dynamic with Debug info
+	@echo Build C Example (Dynamic Debug)...
+	@copy "$(LIB_DIR)\debug\$(WEBUI_LIB_NAME).dll" "$(WEBUI_LIB_NAME).dll"
+	@cl /Zi main.c /I"$(INCLUDE_DIR)" /link /LIBPATH:"$(LIB_DIR)\debug" /SUBSYSTEM:CONSOLE $(WEBUI_LIB_NAME).lib user32.lib Advapi32.lib Shell32.lib Ole32.lib /OUT:main-dyn.exe 1>NUL 2>&1
+#	Clean
+	@- del *.exp >nul 2>&1
+	@- del *.ilk >nul 2>&1
+	@- del *.lib >nul 2>&1
+	@- del *.obj >nul 2>&1
+	@echo Done.
+
+release:
+!IF "$(BUILD_LIB)" == "true"
+	@cd "$(LIB_DIR)" && cd .. && $(MAKE)
+!ENDIF
+#	Static Release
+!IF "$(WEBUI_USE_TLS)" != "1"
+	@echo Build C Example (Static Release)...
+	@cl main.c /I"$(INCLUDE_DIR)" /link /LIBPATH:"$(LIB_DIR)" /SUBSYSTEM:WINDOWS $(WEBUI_LIB_NAME)-static.lib user32.lib Advapi32.lib Shell32.lib Ole32.lib /OUT:main.exe 1>NUL 2>&1
+!ENDIF
+#	Dynamic Release
+	@echo Build C Example (Dynamic Release)...
+	@copy "$(LIB_DIR)\$(WEBUI_LIB_NAME).dll" "$(WEBUI_LIB_NAME).dll"
+	@cl main.c /I"$(INCLUDE_DIR)" /link /LIBPATH:"$(LIB_DIR)" /SUBSYSTEM:WINDOWS $(WEBUI_LIB_NAME).lib user32.lib Advapi32.lib Shell32.lib Ole32.lib /OUT:main-dyn.exe 1>NUL 2>&1
+#	Clean
+	@- del *.exp >nul 2>&1
+	@- del *.ilk >nul 2>&1
+	@- del *.lib >nul 2>&1
+	@- del *.obj >nul 2>&1
+	@- del *.pdb >nul 2>&1
+	@echo Done.
+
+clean:
+	- del *.obj >nul 2>&1
+	- del *.ilk >nul 2>&1
+	- del *.pdb >nul 2>&1
+	- del *.exp >nul 2>&1
+	- del *.exe >nul 2>&1
+	- del *.lib >nul 2>&1

examples/C/react/README.md

@@ -0,0 +1,22 @@
+## React WebUI Example
+
+This is a basic example of how to use WebUI with React to generate a portable single executable program. WebUI will run the internal web server and use any installed web browser as GUI to show the React UI.
+
+A simple Python script `vfs.py` is used to generate `vfs.h` to embed the whole react's build folder into the portable single executable program.
+
+![Screenshot](webui_react.png)
+
+### How to use it?
+
+1. Run script `build_react` to re-build the React project and compile the C file
+
+### How to create a React WebUI project from scratch?
+
+1. Run `npx create-react-app my-react-app` to create a React app using NPM
+2. Add `<script src="webui.js"></script>` into `public/index.html` to connect UI with the backend
+3. Run `python vfs.py "./my-react-app/build" "vfs.h"` to embed the build folder
+4. Now, use any C compiler to compile `main.c` into a portable executable program
+
+### Other backend languages examples:
+
+- Coming soon...

examples/C/react/build_react.bat

@@ -0,0 +1,19 @@
+@echo off
+
+echo.
+echo * Build React project...
+
+cd webui-react-example
+call npm install
+call npm run build
+cd ..
+
+echo.
+echo * Embedding React's build files into 'vfs.h'
+
+python vfs.py "./webui-react-example/build" "vfs.h"
+
+echo.
+echo * Compiling 'main.c' into 'main.exe' using Microsoft Visual Studio...
+
+nmake

examples/C/react/build_react.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+
+echo
+echo "* Build React project..."
+
+cd webui-react-example
+npm install || exit
+npm run build || exit
+cd ..
+
+echo
+echo "* Embedding React's build files into 'vfs.h'"
+
+python3 vfs.py "./webui-react-example/build" "vfs.h"
+
+echo
+echo "* Compiling 'main.c' into 'main' using GCC..."
+
+make

examples/C/react/main.c

@@ -0,0 +1,59 @@
+// React Example
+
+#include "webui.h"
+#include "vfs.h"
+
+void exit_app(webui_event_t* e) {
+    webui_exit();
+}
+
+int main() {
+
+    // Create new windows
+    size_t react_window = webui_new_window();
+
+    // Set window size
+    webui_set_size(react_window, 800, 800);
+
+    // Set window position
+    webui_set_position(react_window, 200, 200);
+
+    // Allow multi-user connection to WebUI window
+    webui_set_config(multi_client, true);
+
+    // Disable WebUI's cookies
+    webui_set_config(use_cookies, false);
+
+    // Bind React HTML element IDs with a C functions
+    webui_bind(react_window, "Exit", exit_app);
+
+    // VSF (Virtual File System) Example
+    //
+    // 1. Run Python script to generate header file of a folder
+    //    python vfs.py "/path/to/folder" "vfs.h"
+    //
+    // 2. Include header file in your C project
+    //    #include "vfs.h"
+    //
+    // 3. use vfs in your custom files handler `webui_set_file_handler()`
+    //    webui_set_file_handler(react_window, vfs);
+
+    // Set a custom files handler
+    webui_set_file_handler(react_window, vfs);
+
+    // Show the React window
+    // webui_show_browser(react_window, "index.html", Chrome);
+    webui_show(react_window, "index.html");
+
+    // Wait until all windows get closed
+    webui_wait();
+
+    // Free all memory resources (Optional)
+    webui_clean();
+
+    return 0;
+}
+
+#if defined(_MSC_VER)
+int APIENTRY WinMain(HINSTANCE hInst, HINSTANCE hInstPrev, PSTR cmdline, int cmdshow) { return main(); }
+#endif

examples/C/react/vfs.py

@@ -0,0 +1,117 @@
+import os
+import sys
+
+def generate_vfs_header(directory, output_header):
+    files = []
+    index_files = {}
+
+    for root, _, filenames in os.walk(directory):
+        for filename in filenames:
+            filepath = os.path.join(root, filename)
+            relative_path = os.path.relpath(filepath, directory)
+            # Ensure path starts with a slash
+            relative_path = '/' + relative_path.replace('\\', '/')
+            files.append((relative_path, filepath))
+
+            # Check for index files
+            if filename.startswith("index."):
+                dir_path = os.path.dirname(relative_path)
+                if dir_path not in index_files:
+                    index_files[dir_path] = relative_path
+
+    with open(output_header, 'w') as header:
+        header.write('#ifndef VIRTUAL_FILE_SYSTEM_H\n')
+        header.write('#define VIRTUAL_FILE_SYSTEM_H\n\n')
+
+        header.write('typedef struct {\n')
+        header.write('    const char *path;\n')
+        header.write('    const unsigned char *data;\n')
+        header.write('    int length;\n')
+        header.write('} VirtualFile;\n\n')
+
+        header.write('static const VirtualFile virtual_files[] = {\n')
+
+        for relative_path, filepath in files:
+            with open(filepath, 'rb') as f:
+                data = f.read()
+                header.write('    {\n')
+                header.write(f'        "{relative_path}",\n')
+                header.write('        (const unsigned char[]){')
+                header.write(','.join(f'0x{byte:02x}' for byte in data))
+                header.write('},\n')
+                header.write(f'        {len(data)}\n')
+                header.write('    },\n')
+
+        header.write('};\n\n')
+
+        header.write('static const int virtual_files_count = sizeof(virtual_files) / sizeof(virtual_files[0]);\n\n')
+
+        header.write('static const char* index_files[] = {\n')
+        for dir_path, index_path in index_files.items():
+            header.write(f'    "{dir_path}/", "{index_path}",\n')
+        header.write('    NULL\n')
+        header.write('};\n\n')
+
+        header.write('bool virtual_file_system(const char* path, const unsigned char** file, int* length) {\n')
+        header.write('    for (int i = 0; i < virtual_files_count; ++i) {\n')
+        header.write('        if (strcmp(virtual_files[i].path, path) == 0) {\n')
+        header.write('            *file = virtual_files[i].data;\n')
+        header.write('            *length = virtual_files[i].length;\n')
+        header.write('            return true;\n')
+        header.write('        }\n')
+        header.write('    }\n')
+        header.write('    return false;\n')
+        header.write('}\n\n')
+
+        header.write('const void* vfs(const char* path, int* length) {\n')
+        header.write('    const unsigned char* file_data;\n')
+        header.write('    int file_length;\n\n')
+
+        header.write('    if (virtual_file_system(path, &file_data, &file_length)) {\n')
+        header.write('        const char* content_type = webui_get_mime_type(path);\n')
+        header.write('        const char* http_header_template = "HTTP/1.1 200 OK\\r\\n"\n')
+        header.write('                                            "Content-Type: %s\\r\\n"\n')
+        header.write('                                            "Content-Length: %d\\r\\n"\n')
+        header.write('                                            "Cache-Control: no-cache\\r\\n\\r\\n";\n')
+        header.write('        int header_length = snprintf(NULL, 0, http_header_template, content_type, file_length);\n')
+        header.write('        *length = header_length + file_length;\n')
+        header.write('        unsigned char* response = (unsigned char*) webui_malloc(*length);\n')
+        header.write('        snprintf((char*) response, header_length + 1, http_header_template, content_type, file_length);\n')
+        header.write('        memcpy(response + header_length, file_data, file_length);\n')
+        header.write('        return response;\n')
+        header.write('    } else {\n')
+        header.write('        // Check for index file redirection\n')
+        header.write('        char redirect_path[1024];\n')
+        header.write('        snprintf(redirect_path, sizeof(redirect_path), "%s", path);\n')
+        header.write('        size_t len = strlen(redirect_path);\n')
+        header.write('        if (redirect_path[len - 1] != \'/\') {\n')
+        header.write('            redirect_path[len] = \'/\';\n')
+        header.write('            redirect_path[len + 1] = \'\\0\';\n')
+        header.write('        }\n')
+        header.write('        for (int i = 0; index_files[i] != NULL; i += 2) {\n')
+        header.write('            if (strcmp(index_files[i], redirect_path) == 0) {\n')
+        header.write('                const char* location_header = "HTTP/1.1 302 Found\\r\\n"\n')
+        header.write('                                            "Location: %s\\r\\n"\n')
+        header.write('                                            "Cache-Control: no-cache\\r\\n\\r\\n";\n')
+        header.write('                int header_length = snprintf(NULL, 0, location_header, index_files[i + 1]);\n')
+        header.write('                *length = header_length;\n')
+        header.write('                unsigned char* response = (unsigned char*) webui_malloc(*length);\n')
+        header.write('                snprintf((char*) response, header_length + 1, location_header, index_files[i + 1]);\n')
+        header.write('                return response;\n')
+        header.write('            }\n')
+        header.write('        }\n')
+        header.write('        return NULL;\n')
+        header.write('    }\n')
+        header.write('}\n\n')
+
+        header.write('#endif // VIRTUAL_FILE_SYSTEM_H\n')
+
+if __name__ == '__main__':
+    if len(sys.argv) != 3:
+        print(f'Usage: {sys.argv[0]} <directory> <output_header>')
+        sys.exit(1)
+
+    directory = sys.argv[1]
+    output_header = sys.argv[2]
+    generate_vfs_header(directory, output_header)
+    print(f'Generated {output_header} from {directory}')

examples/C/react/webui-react-example/.gitignore

@@ -0,0 +1,23 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# production
+/build
+
+# misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

examples/C/react/webui-react-example/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "webui-react-example",
+  "version": "0.1.0",
+  "private": true,
+  "dependencies": {
+    "@testing-library/jest-dom": "^5.17.0",
+    "@testing-library/react": "^13.4.0",
+    "@testing-library/user-event": "^13.5.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-scripts": "5.0.1",
+    "web-vitals": "^2.1.4"
+  },
+  "scripts": {
+    "start": "react-scripts start",
+    "build": "react-scripts build",
+    "test": "react-scripts test",
+    "eject": "react-scripts eject"
+  },
+  "eslintConfig": {
+    "extends": [
+      "react-app",
+      "react-app/jest"
+    ]
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 1 chrome version",
+      "last 1 firefox version",
+      "last 1 safari version"
+    ]
+  }
+}

examples/C/react/webui-react-example/public/index.html

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" href="%PUBLIC_URL%/favicon.ico" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="theme-color" content="#000000" />
+    <meta
+      name="description"
+      content="Web site created using create-react-app"
+    />
+    <link rel="apple-touch-icon" href="%PUBLIC_URL%/logo192.png" />
+    <!--
+      manifest.json provides metadata used when your web app is installed on a
+      user's mobile device or desktop. See https://developers.google.com/web/fundamentals/web-app-manifest/
+    -->
+    <link rel="manifest" href="%PUBLIC_URL%/manifest.json" />
+    <!--
+      Notice the use of %PUBLIC_URL% in the tags above.
+      It will be replaced with the URL of the `public` folder during the build.
+      Only files inside the `public` folder can be referenced from the HTML.
+
+      Unlike "/favicon.ico" or "favicon.ico", "%PUBLIC_URL%/favicon.ico" will
+      work correctly both with client-side routing and a non-root public URL.
+      Learn how to configure a non-root public URL by running `npm run build`.
+    -->
+    <title>WebUI React</title>
+  </head>
+  <body>
+    <noscript>You need to enable JavaScript to run this app.</noscript>
+    <div id="root"></div>
+    <!--
+      This HTML file is a template.
+      If you open it directly in the browser, you will see an empty page.
+
+      You can add webfonts, meta tags, or analytics to this file.
+      The build step will place the bundled scripts into the <body> tag.
+
+      To begin the development, run `npm start` or `yarn start`.
+      To create a production bundle, use `npm run build` or `yarn build`.
+    -->
+
+    <!-- WebUI Script (Virtual File) -->
+    <script src="webui.js"></script>
+
+  </body>
+</html>

examples/C/react/webui-react-example/public/manifest.json

@@ -0,0 +1,25 @@
+{
+  "short_name": "React App",
+  "name": "Create React App Sample",
+  "icons": [
+    {
+      "src": "favicon.ico",
+      "sizes": "64x64 32x32 24x24 16x16",
+      "type": "image/x-icon"
+    },
+    {
+      "src": "logo192.png",
+      "type": "image/png",
+      "sizes": "192x192"
+    },
+    {
+      "src": "logo512.png",
+      "type": "image/png",
+      "sizes": "512x512"
+    }
+  ],
+  "start_url": ".",
+  "display": "standalone",
+  "theme_color": "#000000",
+  "background_color": "#ffffff"
+}

examples/C/react/webui-react-example/public/robots.txt

@@ -0,0 +1,3 @@
+# https://www.robotstxt.org/robotstxt.html
+User-agent: *
+Disallow:

examples/C/react/webui-react-example/src/App.css

@@ -0,0 +1,38 @@
+.App {
+  text-align: center;
+}
+
+.App-logo {
+  height: 40vmin;
+  pointer-events: none;
+}
+
+@media (prefers-reduced-motion: no-preference) {
+  .App-logo {
+    animation: App-logo-spin infinite 20s linear;
+  }
+}
+
+.App-header {
+  background-color: #282c34;
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  font-size: calc(10px + 2vmin);
+  color: white;
+}
+
+.App-link {
+  color: #61dafb;
+}
+
+@keyframes App-logo-spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}

examples/C/react/webui-react-example/src/App.js

@@ -0,0 +1,74 @@
+import React, { useState } from "react";
+
+const App = () => {
+  const [value1, setValue1] = useState('');
+  const [value2, setValue2] = useState('');
+  const [result, setResult] = useState(null);
+
+  const calculateSum = () => {
+    const sum = parseFloat(value1 || 0) + parseFloat(value2 || 0);
+    setResult(sum);
+  };
+
+  return (
+    <div style={{ margin: '20px', fontFamily: 'Arial, sans-serif' }}>
+      <h2>WebUI React Example</h2>
+      <div style={{ marginBottom: '10px' }}>
+        <label>
+          <strong>Input 1:</strong>
+        </label>
+        <input
+          type="number"
+          value={value1}
+          onChange={(e) => setValue1(e.target.value)}
+          style={{ marginLeft: '10px', padding: '5px', fontSize: '16px' }}
+        />
+      </div>
+      <div style={{ marginBottom: '10px' }}>
+        <label>
+          <strong>Input 2:</strong>
+        </label>
+        <input
+          type="number"
+          value={value2}
+          onChange={(e) => setValue2(e.target.value)}
+          style={{ marginLeft: '10px', padding: '5px', fontSize: '16px' }}
+        />
+      </div>
+      <button
+        onClick={calculateSum}
+        style={{
+          padding: '10px 20px',
+          backgroundColor: '#4CAF50',
+          color: 'white',
+          fontSize: '16px',
+          border: 'none',
+          borderRadius: '5px',
+          cursor: 'pointer',
+          marginRight: '10px',
+        }}
+      >
+        Calculate (React Frontend)
+      </button>
+      <button
+        id="Exit"
+        style={{
+          padding: '10px 20px',
+          backgroundColor: '#f44336',
+          color: 'white',
+          fontSize: '16px',
+          border: 'none',
+          borderRadius: '5px',
+          cursor: 'pointer',
+        }}
+      >
+        Exit (WebUI Backend)
+      </button>
+      <div style={{ marginTop: '20px', fontSize: '18px' }}>
+        <strong>Result:</strong> {result !== null ? result : 'N/A'}
+      </div>
+    </div>
+  );
+};
+
+export default App;

examples/C/react/webui-react-example/src/App.test.js

@@ -0,0 +1,8 @@
+import { render, screen } from '@testing-library/react';
+import App from './App';
+
+test('renders learn react link', () => {
+  render(<App />);
+  const linkElement = screen.getByText(/learn react/i);
+  expect(linkElement).toBeInTheDocument();
+});

examples/C/react/webui-react-example/src/index.css

@@ -0,0 +1,13 @@
+body {
+  margin: 0;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
+    'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
+    sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+code {
+  font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New',
+    monospace;
+}

examples/C/react/webui-react-example/src/index.js

@@ -0,0 +1,17 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import './index.css';
+import App from './App';
+import reportWebVitals from './reportWebVitals';
+
+const root = ReactDOM.createRoot(document.getElementById('root'));
+root.render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);
+
+// If you want to start measuring performance in your app, pass a function
+// to log results (for example: reportWebVitals(console.log))
+// or send to an analytics endpoint. Learn more: https://bit.ly/CRA-vitals
+reportWebVitals();

examples/C/react/webui-react-example/src/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 841.9 595.3"><g fill="#61DAFB"><path d="M666.3 296.5c0-32.5-40.7-63.3-103.1-82.4 14.4-63.6 8-114.2-20.2-130.4-6.5-3.8-14.1-5.6-22.4-5.6v22.3c4.6 0 8.3.9 11.4 2.6 13.6 7.8 19.5 37.5 14.9 75.7-1.1 9.4-2.9 19.3-5.1 29.4-19.6-4.8-41-8.5-63.5-10.9-13.5-18.5-27.5-35.3-41.6-50 32.6-30.3 63.2-46.9 84-46.9V78c-27.5 0-63.5 19.6-99.9 53.6-36.4-33.8-72.4-53.2-99.9-53.2v22.3c20.7 0 51.4 16.5 84 46.6-14 14.7-28 31.4-41.3 49.9-22.6 2.4-44 6.1-63.6 11-2.3-10-4-19.7-5.2-29-4.7-38.2 1.1-67.9 14.6-75.8 3-1.8 6.9-2.6 11.5-2.6V78.5c-8.4 0-16 1.8-22.6 5.6-28.1 16.2-34.4 66.7-19.9 130.1-62.2 19.2-102.7 49.9-102.7 82.3 0 32.5 40.7 63.3 103.1 82.4-14.4 63.6-8 114.2 20.2 130.4 6.5 3.8 14.1 5.6 22.5 5.6 27.5 0 63.5-19.6 99.9-53.6 36.4 33.8 72.4 53.2 99.9 53.2 8.4 0 16-1.8 22.6-5.6 28.1-16.2 34.4-66.7 19.9-130.1 62-19.1 102.5-49.9 102.5-82.3zm-130.2-66.7c-3.7 12.9-8.3 26.2-13.5 39.5-4.1-8-8.4-16-13.1-24-4.6-8-9.5-15.8-14.4-23.4 14.2 2.1 27.9 4.7 41 7.9zm-45.8 106.5c-7.8 13.5-15.8 26.3-24.1 38.2-14.9 1.3-30 2-45.2 2-15.1 0-30.2-.7-45-1.9-8.3-11.9-16.4-24.6-24.2-38-7.6-13.1-14.5-26.4-20.8-39.8 6.2-13.4 13.2-26.8 20.7-39.9 7.8-13.5 15.8-26.3 24.1-38.2 14.9-1.3 30-2 45.2-2 15.1 0 30.2.7 45 1.9 8.3 11.9 16.4 24.6 24.2 38 7.6 13.1 14.5 26.4 20.8 39.8-6.3 13.4-13.2 26.8-20.7 39.9zm32.3-13c5.4 13.4 10 26.8 13.8 39.8-13.1 3.2-26.9 5.9-41.2 8 4.9-7.7 9.8-15.6 14.4-23.7 4.6-8 8.9-16.1 13-24.1zM421.2 430c-9.3-9.6-18.6-20.3-27.8-32 9 .4 18.2.7 27.5.7 9.4 0 18.7-.2 27.8-.7-9 11.7-18.3 22.4-27.5 32zm-74.4-58.9c-14.2-2.1-27.9-4.7-41-7.9 3.7-12.9 8.3-26.2 13.5-39.5 4.1 8 8.4 16 13.1 24 4.7 8 9.5 15.8 14.4 23.4zM420.7 163c9.3 9.6 18.6 20.3 27.8 32-9-.4-18.2-.7-27.5-.7-9.4 0-18.7.2-27.8.7 9-11.7 18.3-22.4 27.5-32zm-74 58.9c-4.9 7.7-9.8 15.6-14.4 23.7-4.6 8-8.9 16-13 24-5.4-13.4-10-26.8-13.8-39.8 13.1-3.1 26.9-5.8 41.2-7.9zm-90.5 125.2c-35.4-15.1-58.3-34.9-58.3-50.6 0-15.7 22.9-35.6 58.3-50.6 8.6-3.7 18-7 27.7-10.1 5.7 19.6 13.2 40 22.5 60.9-9.2 20.8-16.6 41.1-22.2 60.6-9.9-3.1-19.3-6.5-28-10.2zM310 490c-13.6-7.8-19.5-37.5-14.9-75.7 1.1-9.4 2.9-19.3 5.1-29.4 19.6 4.8 41 8.5 63.5 10.9 13.5 18.5 27.5 35.3 41.6 50-32.6 30.3-63.2 46.9-84 46.9-4.5-.1-8.3-1-11.3-2.7zm237.2-76.2c4.7 38.2-1.1 67.9-14.6 75.8-3 1.8-6.9 2.6-11.5 2.6-20.7 0-51.4-16.5-84-46.6 14-14.7 28-31.4 41.3-49.9 22.6-2.4 44-6.1 63.6-11 2.3 10.1 4.1 19.8 5.2 29.1zm38.5-66.7c-8.6 3.7-18 7-27.7 10.1-5.7-19.6-13.2-40-22.5-60.9 9.2-20.8 16.6-41.1 22.2-60.6 9.9 3.1 19.3 6.5 28.1 10.2 35.4 15.1 58.3 34.9 58.3 50.6-.1 15.7-23 35.6-58.4 50.6zM320.8 78.4z"/><circle cx="420.9" cy="296.5" r="45.7"/><path d="M520.5 78.1z"/></g></svg>

examples/C/react/webui-react-example/src/reportWebVitals.js

@@ -0,0 +1,13 @@
+const reportWebVitals = onPerfEntry => {
+  if (onPerfEntry && onPerfEntry instanceof Function) {
+    import('web-vitals').then(({ getCLS, getFID, getFCP, getLCP, getTTFB }) => {
+      getCLS(onPerfEntry);
+      getFID(onPerfEntry);
+      getFCP(onPerfEntry);
+      getLCP(onPerfEntry);
+      getTTFB(onPerfEntry);
+    });
+  }
+};
+
+export default reportWebVitals;

examples/C/react/webui-react-example/src/setupTests.js

@@ -0,0 +1,5 @@
+// jest-dom adds custom jest matchers for asserting on DOM nodes.
+// allows you to do things like:
+// expect(element).toHaveTextContent(/react/i)
+// learn more: https://github.com/testing-library/jest-dom
+import '@testing-library/jest-dom';