Skip to main content

Documentation for setting up the development environment for the Modern UI

  • January 6, 2024
  • 7 replies
  • 477 views

Joe Schmucker
Captain II
Forum|alt.badge.img+3

Is there any documentation on how to setup the dev environment for the Modern UI?

The only thing I can find is the PDF of the slides from Andrew Bulanov’s DevCon 2023 presentation.

- Install Node.js of the version 16.14 or higher
- Open a command prompt window, change the directory to FrontendSources folder of the site
- Execute npm run getmodules
- Execute npm run build-dev

I installed the latest version of Node.js from the Node.js web site.

I executed the getmodules command.

I also ran this command to make sure typescript was installed: npm install -g typescript

When I run the last command I get a lot of errors.  Maybe these can be ignored?

Using Node and Typescript is new to me and I was hoping there was a cheat sheet from Acumatica on how to get started.

 

7 replies

Forum|alt.badge.img

hi @Joe Schmucker  - even I got the same issue using the documentation while trying to Execute npm run build-dev
 

any help is appreciated  
CC: @rakeshe45 


Joe Schmucker
Captain II
Forum|alt.badge.img+3
  • Author
  • Captain II
  • March 1, 2024

@ramakrishnan91 

I submitted a case a while back.  I was asked to try 24R1 preview.

I was able to get it to build on this version without any extra fuss.

I am only able to make tweaks to existing screens created by Acumatica.  I have no idea how I will create the html and typescript files for my custom screens.  I’m praying there will be a tool to create them for me.  

 


martinxfe
Jr Varsity II
Forum|alt.badge.img
  • Jr Varsity II
  • April 24, 2024

@Joe Schmucker or anyone really… Do we know; are we supposed to have the ability to generate custom screens in the modern UI at this point, or are we limited to playing with those that come default under FrontendSources?


Reading the documentation, they use all default screens in their examples, so its unclear to me if they are instructing us only how to recompile default screens after modification or telling us we can do this with any screen and they just use default screens as examples. 

 

After dealing with a “cross-env is not recognized” error using  npm install --save-dev cross-env  I was able to get   npm run build-dev -- --env screenIds=|custom screen|  to run successfully with no errors, but it didn’t generate the FrontendSoures files for my custom screen. 

 

I very well may be missing something, but I thought it worth asking the question before I burn time on another 100 derivatives.  


Joe Schmucker
Captain II
Forum|alt.badge.img+3
  • Author
  • Captain II
  • April 24, 2024

@martinxfe I’m still wondering that myself.  I was hoping that Acumatica might make a tool to generate the frontendsources screens.  If I have to create those files myself for my custom screens for the 30+ applications I’ve done, I’m pretty screwed.  I don’t have the knowledge to understand what I would need to do to create those.


martinxfe
Jr Varsity II
Forum|alt.badge.img
  • Jr Varsity II
  • April 24, 2024

Even if we did have to build the html and ts ourselves, at least there is documentation for that. But there’s still the issue that when you attempt to switch a screen to the Modern UI, the site map is locked down to search for |screenID|.html in the ./Scripts/Screens directory before it ever references the ./FrontendSources files.

The default screens all have corresponding html and js files in the ./Scripts/Screens directory, but there’s no documentation that I’ve found that explains how to generate these for custom screens, which tells me either we’ve not yet been provided with this option yet, or else it’s something that is supposed to be handled programmatically, and I’ve simply botched the deployment. 


corey63
Freshman I
  • Freshman I
  • October 17, 2024

I ran into the same issues and solved it by downgrading my node.js software on the server.  What I discovered is that version 20.18 has a security patch that does not allow the child spawn process to take place.  (which is what the scripts use).  

I downgraded to 19.9.0 and I was able to complete the process (despite warnings that my package was out of date) and can report success on 2024 R2. 


darylbowman
Captain II
Forum|alt.badge.img+15

@corey63 Thank you. Saved me time