fix(api-connection): re-enable nx daemon to fix fastapi code generation hot reload (#335)

* fix(api-connection): re-enable nx daemon to fix fastapi code generation hot reload

The nx watch command requires the nx daemon to be running. nx watch is required for detecting
changes to the api and regenerating the client for serve-local

Fixes #333

* docs: add nx troubleshooting page and warning re daemon and nx watch

* docs: update translations

* docs: fix translations

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: cogwirrel

docs/astro.config.mjs

@@ -341,6 +341,33 @@ export default defineConfig({
             },
           ],
         },
+        {
+          label: 'Troubleshooting',
+          translations: {
+            jp: 'トラブルシューティング',
+            ko: '문제 해결',
+            fr: 'Dépannage',
+            it: 'Risoluzione dei problemi',
+            es: 'Solución de problemas',
+            pt: 'Solução de problemas',
+            zh: '故障排除',
+          },
+          items: [
+            {
+              label: 'Nx',
+              translations: {
+                jp: 'Nx',
+                ko: 'Nx',
+                fr: 'Nx',
+                it: 'Nx',
+                es: 'Nx',
+                pt: 'Nx',
+                zh: 'Nx',
+              },
+              link: '/troubleshooting/nx',
+            },
+          ]
+        },
         {
           label: 'About',
           translations: {

docs/src/content/docs/en/guides/api-connection/react-fastapi.mdx

@@ -121,6 +121,10 @@ For more fine-grained control, you can use the `watch-generate:<ApiName>-client`
 />
 :::
 
+:::warning
+`watch-generate:<ApiName>-client` relies on the [`nx watch`](https://nx.dev/docs/guides/tasks--caching/workspace-watching) command, which requires the [Nx Daemon](https://nx.dev/docs/concepts/nx-daemon) to be running. Therefore if you have disabled the daemon, the client won't automatically regenerate when making changes to your FastAPI.
+:::
+
 ### Using the API Hook
 
 The generator provides a `use<ApiName>` hook which you can use to call your API with TanStack Query.

docs/src/content/docs/en/troubleshooting/nx.mdx

@@ -0,0 +1,29 @@
+---
+title: Troubleshooting Nx
+description: Troubleshooting issues with Nx
+---
+import NxCommands from '@components/nx-commands.astro';
+
+This page provides some troubleshooting guidance for issues you may encounter when using Nx.
+
+## Nx Daemon
+
+The [Nx Daemon](https://nx.dev/docs/concepts/nx-daemon) is a process which continuously watches for workspace changes in order to recompute its project graph. This provides a performance boost, particularly for large projects, but can sometimes be the cause of issues depending on your environment.
+
+This can manifest itself in different ways, one of which is the following error:
+
+```bash
+ NX   Could not find project "@scope/project"
+
+Pass --verbose to see the stacktrace.
+```
+
+For this, and any other unexpected error, it's always worth resetting Nx and retrying in case of a daemon issue. You can use the following command:
+
+<NxCommands commands={['reset']} />
+
+Failing this, you can try [disabling the daemon altogether](https://nx.dev/docs/concepts/nx-daemon#turning-it-off).
+
+:::warning
+The `nx watch` command requires the daemon, and therefore some of your hot-reloading targets may not function if you disable it.
+:::