--- title: "Run a Java Applet in the Browser (FoilSim)" source: "https://cheerpj.com/docs/tutorials/applet" --- # Run a Java Applet in the Browser (FoilSim) Running an applet with CheerpJ This tutorial runs a Java applet in a modern browser by adding CheerpJ to the page that hosts it. [View demo](#the-result) The tutorial uses the FoilSim applet from NASA’s [Beginner’s Guide to Aeronautics](https://www.grc.nasa.gov/WWW/K-12/airplane/). The applet is an interactive simulation of the aerodynamic forces on an aircraft wing. [See more](https://www1.grc.nasa.gov/beginners-guide-to-aeronautics/foilsimu/). ## Prerequisites - [Node.js](https://nodejs.org/en/) (>= 18) - A copy of the tutorial [repository](https://github.com/leaningtech/cheerpj-meta.git) ```sh git clone https://github.com/leaningtech/cheerpj-meta.git ``` - Go to the `projectTemplate` directory of the FoilSim-Applet example: ```sh cd examples/FoilSim-Applet/projectTemplate ``` The template project has the following structure: ```plaintext projectTemplate/ ├── index.html └── FoilSim.jar ``` ## 1. Run a web server CheerpJ loads the applet from a web server, so the files must be served over HTTP. [Vite](https://vitejs.dev/) works well during development because it reloads the page when the files change. ```sh npx vite ``` Open the URL shown in the terminal. The page is blank. Leave Vite running for the rest of this tutorial. Alternatively, use the http-server utility: ```sh npx http-server -p 8080 ``` Then open `http://127.0.0.1:8080/` in the browser. > **Note** > > The server must support HTTP Range requests, and the page cannot be opened from file://. Python’s http.server does not support Range requests. See basic server setup. ## 2. Open `index.html` and add your applet content The template is a minimal HTML page. Replace its content with the code below, which adds the applet tag with its attributes, as it would appear on a page written for the Java plug-in, along with a title, credits and some styles. The page uses `` rather than ``. CheerpJ handles both, along with `` and ``, and their `cheerpj-` prefixed versions. The prefixed tag stops a Java plug-in, if one is installed, from trying to run the applet instead of CheerpJ. `index.html` ```html FoilSim applet (CheerpJ)

Applet example with CheerpJ

Your browser cannot handle the applet tag!
The applet shown in this example belongs to the NASA's Beginner's Guide to Aeronautics and it is available at their GitHub repository.
Applet is running with CheerpJ by ©Leaning Technologies
``` Refresh the page. The title and credits are shown, but the applet is not. In its place is the fallback text _**Your browser cannot handle the applet tag!**_ ## 3. Add CheerpJ Add a `

Applet example with CheerpJ

Your browser cannot handle the applet tag!
The applet shown in this example belongs to the NASA's Beginner's Guide to Aeronautics and it is available at their GitHub repository.
Applet is running with CheerpJ by ©Leaning Technologies
``` Refresh the page. The applet runs in place of the fallback text. > **Java applets and Java 8** > > cheerpjInit runs Java 8 when no version is set. Applets run on Java 8 only, so do not set version to 11 or higher on a page that runs an applet. ## The result The finished page looks like this: ## Source code [View full source code on GitHub](https://github.com/leaningtech/cheerpj-meta/tree/main/examples/FoilSim-Applet) ## Credits The applet used in this tutorial belongs to NASA’s [Beginner’s Guide to Aeronautics](https://www.grc.nasa.gov/WWW/K-12/airplane/) and it is available at their [GitHub repository](https://github.com/nasa/BGA/tree/main). ## Further reading - [Run a Java applet](https://cheerpj.com/docs/getting-started/Java-applet.md) - [Runtime API reference](https://cheerpj.com/docs/reference.md)