Skip to main content

Standalone

info

If you are using a bundler, you may choose to skip this section.

You can use cpp.js to compile native code from your project into WebAssembly. To do this, add the build script and cpp.js as a dependency in the package.json file of your project.

package.json
{
"name": "myapp",
"scripts": {
+ "build": "cppjs build -p wasm"
},
"devDependencies": {
+ "cpp.js": "^1.0.0-beta.1"
}
}

To install the npm packages, use the following command:

npm install

Cpp.js requires a configuration file to work. For a minimal setup, create a cppjs.config.mjs file and add the following content.

cppjs.config.mjs
import getDirName from 'cpp.js/src/utils/getDirName.js';

export default {
paths: {
project: getDirName(import.meta.url),
output: 'dist',
},
};

Move your C++ code to the src/native directory. For example;

src/native/MySampleClass.h
#pragma once
#include <string>

class MySampleClass {
public:
static std::string sample() {
return "Hello World!";
}
};

Now, we can compile our C++ code into WebAssembly. Run the following command:

warning

Before proceeding, ensure that you have met all the prerequisites for setting up a working development environment.

npm run build

This command will generate myapp.wasm, myapp.browser.js, and myapp.node.js files inside the dist folder.

├── src
│ └── native
| └── MySampleClass.h
|
├── dist
│ └── myapp.wasm
| └── myapp.browser.js
| └── myapp.node.js
├── ...

You can now access your native code by importing dist/myapp.browser.js into your JavaScript file. For a minimal setup, create a index.html and add the following content.

index.html
<!DOCTYPE html>
<html>
<head>
<meta charset = "utf-8">
<title>Cpp.js Vanilla sample</title>
<script src="./dist/myapp.browser.js"></script>
<script>
initCppJs({ path: './dist' }).then(({ MySampleClass }) => {
document.querySelector('#cppMessage').innerHTML = MySampleClass.sample();
});
</script>
</head>
<body>
<p>Response from c++ : <span id="cppMessage">compiling ...</span></p>
</body>
</html>

To view the output, you can start a local server, such as using the serve command, within the project directory.

tip

To add serve as a project dependency, follow these steps:

package.json
{
"name": "myapp",
"scripts": {
+ "start": "serve",
"build": "cppjs build -p wasm",
},
"devDependencies": {
+ "serve": "^14.2.3",
"cpp.js": "^1.0.0-beta.1"
}
}

To start your project

npm run start
info

Sample Source Code: You can access the sample source code from this link.