Deals summary sample project tutorial (BETA)

To get started, you'll first need to ensure that your CLI is on the latest version that your account is authenticated. If this is your first time setting up your local environment, check out the projects setup guide.

• Update to the latest CLI version by running npm install -g @hubspot/cli@next.
• If you haven't yet connected your production account to the CLI, run hs init to create the necessary hubspot.config.yml file. You can either create this file in your working directory or in one of its parent directories. When working locally, the CLI will use whichever config file is closest, meaning you can also have multiple config files depending on your preferred workflow.

With your local environment set up, you'll now download the sample project and upload it to your account. You'll then be able to view the extension's custom card on any contact record in your account.

• Clone the sample app to your working directory.
• Upload the sample app to your account by running hs project upload, then follow the CLI prompts to complete the upload.
• With the project uploaded, log in to your HubSpot account.
• In your HubSpot account, navigate to Contacts > Contacts.
• Click the name of any contact record. If you're in a new account, you can click the Brian Halligan sample contact, or click Create contact in the upper right to create a new test contact.
• On the contact record, click the Custom tab at the top of the record. On this tab, you'll see the uploaded sample project card titled Deals summary. Because you haven't yet created any deals associated with the contact, the card will show no data.
  

Next, you'll create two deals associated with the contact to populate the card with data.

If your test contact has no deals associated with it, you'll need to create two deals to fill the custom card with data.

• In the Deals card in the right sidebar of the contact record, click + Add.
  
• In the right panel, give the deal a Deal name and amount. Then, click Create and add another at the bottom of the panel.
• Repeat the same step as above to give the second deal a Deal name and amount. Then, click Create at the bottom of the panel.

Because you created these deals from the contact record, they'll automatically be associated with the contact. If you now refresh the page, the card will populate with the aggregated deal data.
Next, you'll start the local development server and update your project with authentication so that you can fetch more deal data using HubSpot's API.

By starting a local development server, you'll be able to update the card's frontend and see your saved changes without needing to upload first. And by adding the private app access token to the project, you'll enable the serverless function to make authenticated requests to the HubSpot deals API. Learn more about running the local development server and managing secrets.

• Run npm install to install dependencies needed for running the local development server.
• Inside the src/app folder, create a new file named .env to store your private app access token.
• Retrieve the private app's access token:
  • In your HubSpot account, navigate to CRM Development.
  • In the left sidebar menu, navigate to Private apps.
  • Click Deals summary app to navigate to the app's overview page.
  • Click the Auth tab.
  • In the Access token section, click Show token. Then, click Copy.
    
  • Paste the token into your .env file using the following format:

• Save the file.
• Start the local development server by running hs project dev, then following the prompts to select the account to develop in.
• Return the contact record in HubSpot and refresh the browser. You should now see an icon on the card that says DEVELOPING LOCALLY.
  

Next, you'll update your local extension files to fetch deal data with the API, calculate average deal margin, and add a new component to the card.

You'll now update the card with a new component to display the calculated average deal margin. You'll first update the card's backend (serverless function), then the frontend React files.

• In your project files, open the get-data.js file. This serverless function is using the HubSpot API client to fetch associated deal data through the getAssociatedDeals function.
• Add the following function to the bottom of the file, below the calculateTotalAmounts function.

• To store the result of this function, update exports.main with a new variable, then add that variable to the existing sendResponse.

• Open the DealsSummary.jsx file, then add the following state variable to define the initial state of the average amount.

• Update the state within the useEffect function.

• Lastly, add a new StatisticsItem component to display the averaged amount in the card.

After making the above changes, the DealsSummary.jsx file should contain the following code:

With your changes saved, you should now see the new component in the card displaying the calculation.

• To quit the local development server and upload your finished work, press q in the terminal, then run hs project upload.