Create a New MPLAB® Harmony v3 Project

This tutorial shows instructions with MHC as the GUI tool. MPLAB Harmony v3 is now configurable through MPLAB Code Configurator (MCC). Visit this page to see the same tutorial page with instructions using MCC as the GUI tool

This page shows you how to create a new MPLAB® Harmony project from scratch.

Before doing this, you'll need to do the following:

If you would rather learn how to open one of the many demonstration application projects that are included in the Harmony framework, visit this page.


In the MPLAB X IDE, select File > New Project. Select 32-bit MPLAB Harmony 3 Project and click Next.

If you don't see this option, you haven't installed the MPLAB Harmony 3 Configurator. See above for details.



Browse to the folder you downloaded the framework to. If you haven't done this, or want to download it to a different folder, click the Launch Content Manager button. Click Next.



Name and Location window:
Location Choose a folder to hold your project. You'll probably want to dedicate the framework download folder for framework files only, so do not choose that.
Folder Choose an MPLAB X physical project name.
Name Choose an MPLAB X logical project name (this can be different from the physical name).
Path You cannot change this. It's generated by the selections above.

To get a better understanding, click on the Show Visual Help button for an explanation.


Click Next.


Choose a name for the MPLAB X IDE project configuration (or just keep the default name). Select the target device for your project and click Finish.

Microchip has hundreds of 32-bit devices. Use the Device Family and/or Device Filter fields to narrow the Target Device selection.



Your new project will open in the IDE and the MPLAB Harmony Configurator will automatically start. Keep the default values in the Configuration Database Setup window and click the Launch button.

© 2024 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.