How to use exactly orchy-core server?

[nicolalandro]

How to correctly configure and run Orchy as an orchestrator of the micro frontend?

I'm studying Orchy on that codebase and I correctly created a svelte mfe (orchy/svelte-mfe) using the cli.
After I prepare and run the server:

...
"scripts": {
    "prepare": "cd ./node_modules/orchy-core && pnpm i",
    "orchy": "cd ./node_modules/orchy-core && pnpm w:wc dev",
    ...
}
...

I see the error that it cannot reach something like /api/v1/configuration/ so I write the orchy-config.json, page-config.json and page-cnfig.html into orchy/orchy_static and I serve it correctly using fastify (orchy/main.js):

...
fastify.register(require('@fastify/static'), {
    root: path.join(__dirname, 'orchy_static'),
    prefix: '/api/v1/configuration/',
})
...

If I go to localhost:3000/api/v1/configuration/page-config.com work but because the HTML that I wrote works in a normal web browser, instead the localhost:5173 seems not to work also if the warning is solved.

What do I wrong? How to use it correctly?

[ilteoood]

Hi Nicola,
I suggest you to take a look at the installation process.

As you'll see, you don't have to install all the orchy-core repository, but just some of its packages which are published on NPM.

About the server, you can actually use whatever you want to expose your static configuration (even the plain serve command is fine)

[nicolalandro]

But I do not understand how to use the page-config.json how to serve it as a web page? Is it like micro-lc playground or do I understand wrong?

[ilteoood]

That file is used by the orchy orchestrator to download the configuration of the Micro-frontends.
You just need to serve it using your web server

[ilteoood]

If you have experience with docusaurus, here is how they are exposed for the project documentation: https://github.com/orchy-mfe/orchy-doc/tree/main/static/api/v1/configuration

[nicolalandro]

U speack about the file that I find for example in that example: https://github.com/orchy-mfe/orchy-examples/tree/main/examples/communication-mfe-iframe that have a page-config.json, but it seams similar to the documentation that you share with me, so I must search about docusaurus. I search and I close this thread soon.

[ilteoood]

All these json files are used to configure orchy. You just need to expose them in the /api/v1/configuration path using the web server you like

[nicolalandro]

and so I return to my problem I serve that files at /api/v1/configuration, so when I go to localhost:3000/api/v1/configuration/page-config.html it work.
But when I go to localhost:5173 it seams do not work I see:

But if I go to localhost:3000/api/v1/configuration/page-config.html I see:

[ilteoood]

Looking at the code you provided, you are just exposing orchy's configurations without using the orchestrator. Additionally, you are not exposing them in the /api/v1/configuration path