Skip to content

Commit 21bce2a

Browse files
docs: Invalid character: "<"
Signed-off-by: David Dal Busco <david.dalbusco@outlook.com>
1 parent 389e194 commit 21bce2a

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

docs/troubleshooting.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,38 @@ Make sure these two requirements are correctly met before restarting the command
5353

5454
---
5555

56+
### Invalid character: "&lt;"
57+
58+
When you scaffold an app with a template, the `juno.config` file includes placeholder values for the satellite IDs:
59+
60+
```typescript
61+
import { defineConfig } from "@junobuild/config";
62+
63+
export default defineConfig({
64+
satellite: {
65+
ids: {
66+
development: "<DEV_SATELLITE_ID>",
67+
production: "<PROD_SATELLITE_ID>"
68+
},
69+
source: "dist"
70+
}
71+
});
72+
```
73+
74+
If you start your frontend development server without replacing these placeholders, you may encounter an error like: `Invalid character: "&lt;"` while running your app in the browser.
75+
76+
This happens because the app tries to parse the config at runtime and encounters the invalid placeholder character `<` in the ID values.
77+
78+
Continue with your setup or tutorial until you receive your actual satellite ID(s). Once you’ve updated the config with real values, make sure to restart your development server.
79+
80+
:::note
81+
82+
Note: `vite` may cache the configuration — if the error persists after updating the file, try restarting the dev server with the `--force` flag or make a small code change to trigger a rebuild.
83+
84+
:::
85+
86+
---
87+
5688
### Canister exceeded its current Wasm memory limit
5789

5890
Every Satellite, and generally any module on Juno, starts with a default heap memory limit of 1 GB. While you can increase this limit in the settings, it's not recommended to go beyond it, as it may cause issues when upgrading your module.

0 commit comments

Comments
 (0)