Start a Project

To get started with the Espressif-IDE, you can create a new project or import an existing project.

  1. Create a New Project

  2. Create a New Project Using ESP-IDF Templates

  3. Import an Existing Project

Create a New Project

To create a new Project in the Espressif-IDE, follow the steps below:

  1. Go to File > New > Espressif IDF Project.

  2. Provide the Project name

  3. Click Finish.

Note

The ESP-IDF build system does not support spaces in the paths to either ESP-IDF or to projects.

_images/newproject_menu.png

Create a New Project Using ESP-IDF Templates

Espressif-IDE also offers the ability to create a project using the ESP-IDF templates, which can be accessed by following the steps below:

  1. Go to File > New > Espressif IDF Project.

  2. Choose a target board from the Select Project Target dropdown.

  3. Click on Create a project using one of the templates from the Templates section.

  4. Select the template you want to use and that automatically fills the project name based on the template selected.

  5. Click Finish.

_images/3_new_project_default.png

Note

You may see numerous unresolved headers and symbols errors in the editor, and these will only be resolved after the build process.

Import an Existing Project

To import an existing project into the Espressif-IDE, please make sure that is a CMake project. Follow the steps below:

  1. Right-click in the Project Explorer.

  2. Select Import.. Menu.

  3. Select Existing IDF Project from Espressif import wizard menu list.

  4. Click Next.

  5. Click on Browse... to choose an existing project location directory.

  6. Provide Project name if you wish you have a different name.

  7. Click Finish to import the selected project into Eclipse workspace as a CMake project.

_images/5_import_project.png