Create a Project¶ An integration project in WSO2 Integrator: MI is a structured collection of artifacts designed to facilitate seamless communication and data exchange between diverse systems, applications, and services. Creating a Project¶ Follow the below steps to create an integration project using the WSO2 Integrator: MI for VS Code extension (MI for VS Code). Launch Visual Studio Code with the MI for VS Code extension installed. Info Follow the Install WSO2 Integrator: MI for VS Code documentation for a complete installation guide. Click on the WSO2 Integrator: MI icon on the Activity Bar of the VS Code editor. This opens the WSO2 Integrator: Integrations panel. Click Get Started to open the Welcome page. Click Create under Create New Project. In the Project Creation Form, enter a suitable name for the integration project under Project Name. Ensure the relevant product version is selected as the WSO2 Integrator: MI runtime version. Provide a location for the integration project under Project Directory. Click Create. Once you click Create, the Add Artifact pane will be opened. Note You need the following to work with the MI for VS Code extension. Java Development Kit (JDK) version 25 WSO2 Integrator: MI 4.7.0 runtime If you don't have them installed in your local machine, these will be automatically prompted for downloading and configured by the WSO2 Integrator: MI for VS Code extension during the project creation step: Click Download Java & MI to download and set up Java and MI runtime. Info If a different version of the JDK or WSO2 MI is installed on your local machine, you'll be prompted to download the required versions. Click Download to install the required JDK or/and MI version(s). Once the download is complete, configure the Java Home or/and MI Home paths by clicking Select Java Home or/and Select MI Path, respectively. If the required JDK and WSO2 MI versions are already installed, you can directly configure the Java Home and MI Home paths in this step by clicking Select Java Home and Select MI Path, respectively. Once the process is complete, a window reload will be required, and you will be prompted with the following message: Click Reload Window. Now you can start creating your integration by developing artifacts. See the Integration Artifacts Overview documentation to learn about the integration artifacts. Additionally, you can enhance your experience by incorporating AI-powered assistance with WSO2 Integrator Copilot. Creating Multiple Projects in a Workspace¶ You are not limited to a single integration project per VS Code window. You can create additional integration projects alongside an already open project, so that you can view and work with them together in the WSO2 Integrator: MI Project Explorer. To create another project in your current workspace: Click the + icon at the top of the WSO2 Integrator: MI Project Explorer pane. This will open the same Welcome page shown in step 4 of Creating a Project above. Follow steps 4 to 8 under Creating a Project to complete the Project Creation Form for the new project. Once created, the new project will be added alongside the existing one, and both will be listed together in the WSO2 Integrator: MI Project Explorer, allowing you to manage multiple integration projects side by side. Info If you want to bundle several related integration modules together under a single project instead of maintaining them as separate projects in a workspace, consider creating a consolidated project instead. You can also convert an existing workspace into a consolidated project directly, without recreating your projects. Creating a Consolidated Project¶ A consolidated project bundles multiple integration modules into a single multi-module integration project, instead of creating each module as a separate, independent project. This is useful when you have several related integration modules that you want to organize, build, and version together under one parent project, rather than managing them as individual projects added to a workspace. To create a consolidated project, follow the same steps as creating a project above, and on the Project Creation Form: Expand Advanced Options, and then expand Project Configurations. Select the Consolidated Project checkbox. Click on Add Module to add a module to the consolidated project and provide a name for it. Repeat this step for each module you want to include. Click Create Project. Converting a workspace to a consolidated project If you already have multiple integration projects added to the same VS Code workspace, you do not need to recreate them to get a consolidated project. You can merge the existing projects in the workspace into a single consolidated project instead: Open the Workspace Overview page. It lists all the projects currently added to the workspace, under Projects. Expand the Advanced section at the bottom of the page. Click Convert to Consolidated next to Convert to Consolidated Project. This will merge all the projects listed in the workspace into a consolidated project, with each existing project becoming a module of it, so that they share build and deployment options.