Import React file from the plugin' settings folder

Is it possible to import a react component (.jsx file) from the plugin settings folder and then show it in the main App.js ?

The XD API looks like this:

const fs = require("uxp").storage.localFileSystem;
const folder = await fs.getDataFolder(); // plugin settings folder
const entries = await folder.getEntries("SettingsComponent.js"); // look inside it

but how to insert it in the App.js? Looks like impossible :confused:

This doesn’t sound like it’s possible. From my understanding of React, it get’s compiled to vanilla javascript which will then be executed during runtime. So if you read a file (which happens during runtime), the underlying code isn’t really part of the React framework anymore. You could of course manipulate the HTML DOM manually, but I guess that wasn’t what you intented.

What are you trying to achieve / what is the specific usecase?

1 Like

Hi @simonhenke I just want to import a React component (a file) that is on the setting folder.

this is how you would regularly import a component inside the App.js:

const Component = require("./components/Component");

but, as you can see the plugin settings folder is not that easy to require as a string would be.

And it’s definitely necessary for the file to sit inside the settings folder?
Can’t you just have it inside your project structure and import it from there? You could have any other settings file inside the settings folder and read it, then display the component (or not) based on this file or parameter you read.

The problem is that fs.getDataFolder() is a function, so it retrieves the correct path during runtime. That’s already to late though, your React imports get processed during the compilation/bundling step.

yes, because I receive that code server side. So I save it in a react file (.js) and if I could import it properly I could use it inside the plugin.

Eventually what I want to do is what .innerHTML would do in vanilla javascript, but that’s not allowed in React (meaning is forbidden). So, I am trying to find a way to actually include some code from outside (in this case the settings folder)

Interesting, I’ve never heard of such a use case. Why does the React Component have to come from a server during runtime?

.innerHTML sets the content of an Element, while respecting HTML syntax, doesn’t it?
So for example you could add '<p>someText</p>’ to a DIV-Element and it would get added as a child.
A full React Component compiles to more than just HTML-Elements though. There might be instance variables, functions, event callbacks etc.

I’m probably not much of a help, sorry :smiley: Maybe someone else knows more about such a use case.

1 Like

@kerrishotts please help me out :pray::pray::pray:

Maybe it would help to better understand your particular use case.

React generally depends upon bundlers and transpilation, which means it’s not going to be able to easily include a file from outside its compilation environment as a component. And then never mind getting everything to be wired up correctly so that events work, state is properly handled, etc.

I’ll note that downloading and executing code off your server is generally not considered a great idea – there are a whole host of security risks in doing so. While UXP is sandboxed, there are definitely ways beyond accessing the file system that could harm your user should an attacker compromise the code you received from the server.

I’m going to assume a few things at this point, given the name of the component – I’m guessing this is a list of preferences, and that the list of preferences itself is often modified or generated from elsewhere, and you’re trying to re-use it. In this case, I’d suggest a more generic approach, and encode the settings layout as a JSON file that you could then use to re-construct everything in the UI.

It wouldn’t be horribly difficult to do so with a reasonably simple React component iterating over the fields in the JSON object and creating UI controls based on what’s inside. In fact, there’s probably a few re-usable React components that might already do that for you.

All of that to say that if that’s your use case, you don’t need to download actual code to get the desired functionality.

1 Like

Thanks for the tips, but unfortunately there is more code involved than having a just a few settings written in a json. BTW, it’s called “SettingsComponent” because it comes from the settings folder (please read it as “ComponentFromSettingsFolder”).

Alright, let me explain what my use-case is:

  1. I need to server-side get a new component (saving it as a file, in the plugin settings folder) and then show it in the plugin interface in XD. The component has html-UI, script logic: functions, handle state and more.

  2. I want to bypass the waiting for the XD team to publish the plugin on the store, because frequent XD’s API changes or my possible mistakes and also because I want to have a few of this functionality received via a payment-gate.

  3. The server will be secured via SSL and since UXP is sandboxes, I see a close-to-none risk of someone hacking is any way, shape or form.

  4. It would be no problem if React would allow the javascript’s innerHTML method on a ref but, since it’s not allowed to use scripts, I cannot take this approach. The only solutions I see is via components-as-a-file to be rendered in the main.The problem is I don’t know how to pick them from that folder.

@kerrishotts Any suggestion is much appreciated :pray:

I have tried react-live which is suppose to render react ( but it got this error in the plugin UI:


Also tried this approach… nothing :frowning:

const MyLazyComponent = React.lazy(
  () =>
    new Promise(async (resolve) => {
      const folder = await fs.getDataFolder();
      const entries = await folder.getEntries();
      // entries.forEach((entry) => console.log(;
      // entries.forEach((entry) => console.log(entry.url));
      // entries.forEach((entry) => console.log(entry.nativePath));
      const file = await entries.find(
        (entry) => === "ServerCode.js"
      const module = await import(file.nativePath);
      console.log("MODULE", module);
      setTimeout(() => resolve(module), 1000);
  return (
    <panel className={styles.panel}>
      <React.Suspense fallback={<div>Loading...</div>}>
        {MyLazyComponent ? <MyLazyComponent /> : null}


EvalError: Code generation from strings disallowed for this context

I wonder why this gets triggered and how to bypass it :flushed:

I also added in webpack.config.js:

  mode: "production",

but no success

Anything that tries to evaluate a string as code (eval, new Function, etc.) is not allowed in the XD plugin context. There’s no real good way around it.

I’ll note that #2 above (avoiding the review process) is not a great reason to try this – you may end up on the bad end of things if something fails badly enough and enough people report / negatively review the plugin. I’ve included @ashryan in case he has more to say.

For #3, UXP is sandboxed, yes, but that doesn’t mean that an attacker couldn’t use social engineering to try and get your user to do something wrong. SSL is also susceptible to man-in-the-middle attacks (especially on captive networks, such as hotels use).

Of course when downloading things remotely, you’ll also have to handle the case where there’s no network connection or the file is corrupt. W/ JS that probably means a broken plugin if there’s a failure, unless you catch that appropriately elsewhere.

You might be able to get SSR/hydration to do something of use here, but generally I think it’d be way easier to use a DSL of sorts (w/ JSON or the like) than it would be to try and get a plugin to load a remote React component…