Unclear how to use nuxt 2.9 programmaticly with typescript

What problem does this feature solve?

Hello, I use nuxt 2.8 with typescript and koa, so far I was able to get things to work using cross-env NODE_ENV=development ts-node-dev -P ./server/tsconfig.json --transpile-only server/index.ts --watch server for my dev script and nuxt build && tsc -p ./server/ for my build script

With nuxt 2.9 I have to use nuxt-ts to make nuxt compile my vuex modules, if I dont I get this error: [vuex] module namespace not found in mapGetters(): But if I use nuxt-ts then my server wont run, how am I suppose to do this correctly?

What does the proposed changes look like?

Add some documentation about running nuxt problematically.

<div align="right">_{This feature request is available on Nuxt community (#c9844)}</div>

[kevinmarrec]

Programmatic usage is documented, but not for TypeScript. Overall all internals of nuxt aren’t typed, which means Nuxt & Builder classes are not easy to use (you need to @ts-ignore). See https://github.com/nuxt/typescript/issues/44

why is programmatic usage are not recommended by the way?

Overall it add complexity and people asking for help, meanwhile more convenient solutions may/must fit your use cases.

I highly recommend a blog post from one of our core team members @manniL : https://blog.lichter.io/posts/nuxt-with-an-api

Having your server both delivering vue app & serving api means you’re limiting your application to be a Monolith, which in other means : one single block, indivisible, slow/hard to change.

Separating your frontend (Nuxt) and your backend (API) makes thing easier in several fields :

• Recruitment: focus on recruting specialists in frontend (Vue.js/Nuxt), or backend (Node.js, Laravel, etc…)
• Maintenance : Independent versioning and separation of concerns just make things easier
• Performance : If your server server API requests as well as SSR Nuxt renders, it may happen it results in really slow page display when API is heavily requested. It also comes with resources used by your servers. With a monolith it will become really hard to know if a RAM issue is cause by Nuxt or your Express (or other lib) server.

There are probably many other advantages but won’t enumerate all.

Still, Nuxt programmatic usage can answer to some use cases i’m not aware of OR not experienced in.

[kevinmarrec]

Closed by #233