Skip to content

feat(docs): add compatible Node.js and Python versions to Build Your … #71

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Sep 24, 2025
Merged

feat(docs): add compatible Node.js and Python versions to Build Your … #71

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
7f8e163
feat(docs): add compatible Node.js and Python versions to Build Your …
abbesBenayache Sep 23, 2025
6b26e46
refactor(docs): eliminate duplication by centralizing prerequisites i…
abbesBenayache Sep 23, 2025
d32c55a
Merge remote-tracking branch 'origin/main' into feat/add-compatible-n…
abbesBenayache Sep 23, 2025
b7b3c2d
style: fix prettier formatting issues
abbesBenayache Sep 23, 2025
4a37224
fix(docs): clarify Node.js version requirement for JavaScript iApps
Le-Caignec Sep 24, 2025
a34e1f2
Merge branch 'main' into feat/add-compatible-node-python-versions
Le-Caignec Sep 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion src/get-started/helloWorld.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -102,10 +102,17 @@
</div>
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
📦 Node.js v20+
📦 Node.js v20+ (for javascript iApps)

Check notice on line 105 in src/get-started/helloWorld.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/get-started/helloWorld.md#L105 

[Google.Parens] Use parentheses judiciously.
Raw output 
{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "src/get-started/helloWorld.md", "range": {"start": {"line": 105, "column": 22}}}, "severity": "INFO"}

Check failure on line 105 in src/get-started/helloWorld.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/get-started/helloWorld.md#L105 

[Vale.Terms] Use 'Javascript' instead of 'javascript'.
Raw output 
{"message": "[Vale.Terms] Use 'Javascript' instead of 'javascript'.", "location": {"path": "src/get-started/helloWorld.md", "range": {"start": {"line": 105, "column": 27}}}, "severity": "ERROR"}

Check failure on line 105 in src/get-started/helloWorld.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/get-started/helloWorld.md#L105 

[Vale.Spelling] Did you really mean 'iApps'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'iApps'?", "location": {"path": "src/get-started/helloWorld.md", "range": {"start": {"line": 105, "column": 38}}}, "severity": "ERROR"}
<InfoIcon tooltip="Required runtime environment for running JavaScript code and managing project dependencies" />
</div>
<a target="_blank" href="https://nodejs.org/en/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
</div>
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
🐍 Python 3.8+ (for Python iApps)

Check notice on line 112 in src/get-started/helloWorld.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/get-started/helloWorld.md#L112 

[Google.Parens] Use parentheses judiciously.
Raw output 
{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "src/get-started/helloWorld.md", "range": {"start": {"line": 112, "column": 21}}}, "severity": "INFO"}

Check failure on line 112 in src/get-started/helloWorld.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/get-started/helloWorld.md#L112 

[Vale.Spelling] Did you really mean 'iApps'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'iApps'?", "location": {"path": "src/get-started/helloWorld.md", "range": {"start": {"line": 112, "column": 33}}}, "severity": "ERROR"}
<InfoIcon tooltip="Required runtime environment for Python-based iExec applications" />
</div>
<a target="_blank" href="https://www.python.org/downloads/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
</div>
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
Expand Down
26 changes: 3 additions & 23 deletions src/get-started/helloWorld/3-buildIApp.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,29 +26,9 @@ experience.

## 📋 Prerequisites

Before getting started, make sure you have:

<div class="flex flex-col gap-2 my-4 pl-0">
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
📦 Node.js v20+
</div>
<a target="_blank" href="https://nodejs.org/en/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
</div>
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
🐳 Docker installed
</div>
<a target="_blank" href="https://docker.com/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
</div>

<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
🐳 DockerHub Account
</div>
<a target="_blank" href="https://hub.docker.com/" class="no-underline! text-sm ml-auto hover:underline!">Sign Up →</a>
</div>
</div>
Before getting started, make sure you have the required tools installed. See the
[iApp Generator Getting Started guide](/references/iapp-generator/getting-started)
for detailed prerequisites and installation instructions.

::: info

Expand Down
50 changes: 3 additions & 47 deletions src/guides/build-iapp/build-&-test.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,53 +29,9 @@ iApp Generator handles all the low-level complexity for you.

## Prerequisites

Before getting started, make sure you have the following installed:

<div class="flex flex-col gap-2 my-4 pl-0">
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
📦 Node.js v20+
</div>
<a target="_blank" href="https://nodejs.org/en/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
</div>
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
🐳 Docker installed
</div>
<a target="_blank" href="https://docker.com/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
</div>

<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
🐳 DockerHub Account
</div>
<a target="_blank" href="https://hub.docker.com/" class="no-underline! text-sm ml-auto hover:underline!">Sign Up →</a>
</div>
</div>

## Installation

First, install the iApp Generator CLI tool using your preferred package manager:

::: code-group

```sh [npm]
npm install -g @iexec/iapp
```

```sh [yarn]
yarn global add @iexec/iapp
```

```sh [pnpm]
pnpm add -g @iexec/iapp
```

```sh [bun]
bun add -g @iexec/iapp
```

:::
Before getting started, make sure you have the required tools installed. See the
[iApp Generator Getting Started guide](/references/iapp-generator/getting-started)
for detailed prerequisites and installation instructions.

## Quick Start

Expand Down
8 changes: 8 additions & 0 deletions src/references/iapp-generator/building-your-iexec-app.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,14 @@ description:

# 🧑‍🏭 Build your iApp

::: tip 📋 Prerequisites

Before building your iApp, make sure you have the required tools installed. See
the [Getting Started guide](/references/iapp-generator/getting-started) for
detailed prerequisites and installation instructions.

:::

## 🧰 Initialize your iApp

The iApp (iExec App) Generator command-line tool simplifies the setup of your
Expand Down
8 changes: 7 additions & 1 deletion src/references/iapp-generator/getting-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,15 @@
<div class="flex flex-col gap-2 my-4 pl-0">
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
📦 Node.js v20+
📦 Node.js v20+ (for javascript iApps)

Check notice on line 17 in src/references/iapp-generator/getting-started.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/references/iapp-generator/getting-started.md#L17 

[Google.Parens] Use parentheses judiciously.
Raw output 
{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "src/references/iapp-generator/getting-started.md", "range": {"start": {"line": 17, "column": 22}}}, "severity": "INFO"}

Check failure on line 17 in src/references/iapp-generator/getting-started.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/references/iapp-generator/getting-started.md#L17 

[Vale.Terms] Use 'Javascript' instead of 'javascript'.
Raw output 
{"message": "[Vale.Terms] Use 'Javascript' instead of 'javascript'.", "location": {"path": "src/references/iapp-generator/getting-started.md", "range": {"start": {"line": 17, "column": 27}}}, "severity": "ERROR"}

Check failure on line 17 in src/references/iapp-generator/getting-started.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/references/iapp-generator/getting-started.md#L17 

[Vale.Spelling] Did you really mean 'iApps'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'iApps'?", "location": {"path": "src/references/iapp-generator/getting-started.md", "range": {"start": {"line": 17, "column": 38}}}, "severity": "ERROR"}
</div>
<a target="_blank" href="https://nodejs.org/en/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
</div>
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
🐍 Python 3.8+ (for Python iApps)

Check notice on line 23 in src/references/iapp-generator/getting-started.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/references/iapp-generator/getting-started.md#L23 

[Google.Parens] Use parentheses judiciously.
Raw output 
{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "src/references/iapp-generator/getting-started.md", "range": {"start": {"line": 23, "column": 21}}}, "severity": "INFO"}

Check failure on line 23 in src/references/iapp-generator/getting-started.md

View workflow job for this annotation

GitHub Actions / vale

[vale] src/references/iapp-generator/getting-started.md#L23 

[Vale.Spelling] Did you really mean 'iApps'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'iApps'?", "location": {"path": "src/references/iapp-generator/getting-started.md", "range": {"start": {"line": 23, "column": 33}}}, "severity": "ERROR"}
</div>
<a target="_blank" href="https://www.python.org/downloads/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
</div>
<div class="flex items-center gap-4 text-left">
<div class="flex items-center gap-1 flex-1 text-sm font-medium">
Expand Down