Skip to main content

Help needed: Setting up development environment for Integration app (first-time developer)

  • February 11, 2026
  • 1 reply
  • 46 views
I
  • Ira
  • New Participant

Hello monday.com Developer Community,

I'm a first-time monday.com app developer trying to set up my development environment to build an Integration app using the Quickstart Integration tutorial. I'm encountering several issues and would appreciate guidance on the complete setup process.
 

Current issue:
When I try to deploy using mapps code:push, I get the error: "Failed in uploading the project." The deployment shows as "pending" but never completes.

What I need help understanding:

  1. Complete deployment workflow - What are the correct steps from code download to working app?
  2. Local development vs deployment - Should I test locally first using a tunnel, or deploy directly to monday code?
  3. Configuration in Developer Center - Where exactly do I add the Base URL for my integration feature?
  4. Environment setup - Are there any other prerequisites or configurations I might be missing?

1 reply

G
  • g.agoncillo
  • New Participant
  • February 12, 2026

Hi there. We’re currently developing apps as well and we’re pretty new also. I don’t know if this will help but here is what we are doing when development, and also deployment.

- Our app uses ReactJS for client side and ExpressJS on the server side. And both are hosted in monday.com developer center.
- For NodeJS, we’ve encountered an issue also when doing deployment since we’re also using typescript. We even ask the other community platform for help, you can visit it here. But what we did to resolve this is even the types package of all the package that we use in the project, we store it in “dependencies” not in “devDependencies”. I don’t know if this is a best practice or other might see this wrong, but in our use-case it works and we don’t touch it anymore since we focus our time on developing our app.

Now to give some feedback on your questions.
1. Complete deployment workflow - What are the correct steps from code download to working app?
Ans: The most important is setting up the .mappsrc file. You can follow this guide. Now after deployment, we think monday.com server finds your “npm run start” script to start your application (especially server-side code). I suggest to set your script that will open your application in start command under scripts in your package.json. Both client and server side code.

2. Local development vs deployment - Should I test locally first using a tunnel, or deploy directly to monday code?
Ans: Both case are okay. What we do is 1.) If we’re just developing a UI, or API that doesn’t need the graphql API of monday.com, we just test locally. 2.) But if we’re doing testing that involves intergration with monday.com boards, item views, graphql API, That’s we’re we do deployment every test.

3. Configuration in Developer Center - Where exactly do I add the Base URL for my integration feature?
Ans: I not sure on this as our app doesn’t use integration feature(so far) but you can read this guide.

 

4. Environment setup - Are there any other prerequisites or configurations I might be missing?
Ans: Base on our experience, none. We have full control in our app (App version, env variables, etc)


Calling out monday.com team as well maybe they can have feedback regarding your concern. I just shared what we experienced in developing a monday.com app.

 

Terms & ConditionsCookie settingsAccessibility statement