Skip to content

create-react-app should allow TypeScript imports outside src #8785

Open

Description

@bluenote10

Is your proposal related to a problem?

Code reuse is a good thing. It is not uncommon that a backend and a frontend can use the same code, and live in the same repository. The need for sharing code is particularly strong with TypeScript type definitions, because developers on the backend and the frontend want to make sure that they are building against a common types.

Describe the solution you'd like

I don't know the CRA internals, but maybe one of the following:

  • Allow baseUrl to point outside . to enable absolute imports like `import * as foo from 'common/foo``.
  • Enable relative imports outside src like import * as foo from '../../common/foo'.

Describe alternatives you've considered

There are work-arounds using a combination of third-party cra-patching libraries. They are tedious to setup though (I worked 3 evenings on coming up with a solution), potentially fragile, and the use case seems so fundamental that I'm very surprised that it is not to supported out-of-the-box.

Activity

  1. getspooky commented on Apr 6, 2020

    @getspooky

    Hi @bluenote10
    You can disable this feature but only after eject operation of create-react-app project or use react-app-rewired package this way you do not have to eject.

  2. bluenote10 commented on Apr 7, 2020

    @bluenote10
    Author

    I know that it is possible, as I have documented in the link.

    However the process to get there is out of proportion. The area of working against the CRA defaults is quite a mess for a newbie, and because the settings of CRA are hidden, documentation is poor. I worked on the solution for 3 evenings, roughly 3 hours each. Isn't it crazy to be stuck for such a long time on a basic configuration problem, not doing anything productive? I thought the idea of CRA was to get people going quickly. After spending 9 hours on solving a problem that seems to be a basic requirement and facing limitations that have no clear motivation at all, I thought I report my experience.

  3. timtaranov commented on Apr 25, 2020

    @timtaranov

    +1, typescript should be enabled for outside the src folder by default. Or at least there has to be a way to import typescript dependencies by relative path in package.json - which seems to be currently impossible to do, without ejecting and pretty much losing any benefit of cra.

      "dependencies": {
        "@mycore-ui": "file:./../mycore-ui"
       }
    

    I'd think this should work even if the mycore dependency above is in written in typescript

  4. CodingDive commented on Jun 10, 2020

    @CodingDive

    I agree that code sharing should be encouraged and easier as long as the import does not leave the repository.
    Also related to #1333 which has yet to receive any update from a CRA maintainer.

  5. xinghul commented on Oct 3, 2020

    @xinghul

    +1, I would say this is one of the deal-breakers for us, we have lots of shared components and utility functions/classes, and sharing them across multiple CRA projects has been more than painful.

    Ofc we can hack our way through this, using things like react-app-rewired or craco, but it's not an ideal solution, and I'm curious to know why is this not supported out of the box?

  6. timtaranov commented on Oct 3, 2020

    @timtaranov

    just to document react-app-rewired/customize-cra workaround for anyone looking for a solution:

    • add external typescript source dependencies into project's package.json
      "dependencies": {
    ...
        "component-ui": "file:./../component-ui",
    ...
      },
    
    • install react-app-rewired and customize-cra and replace script build/start/test eact-app-rewired build/start/test
    • add config-overrides.js into cra project's root with
    const {removeModuleScopePlugin, override, babelInclude, addWebpackAlias} = require("customize-cra");
    const path = require("path");
    
    module.exports = override(
      removeModuleScopePlugin(),
      addWebpackAlias({
    ...
        ["component-ui"]: path.resolve(__dirname, "../component-ui")
    ..
      }),
      babelInclude([
        path.resolve("src"),
        path.resolve("../component-ui/src")
      ])
    );
    

    with these changes, CRA starts detecting and building typescript codebases outside of the project src tree.

  7. bluenote10 commented on Nov 27, 2020

    @bluenote10
    Author

    @ttaranov react-app-rewired stopped supporting CRA at version 2.0 and now we are at 4.0, so isn't this a very fragile setup?

  8. ryota-murakami commented on May 21, 2021

    @ryota-murakami
    Contributor

    @bluenote10 I had facing this problem lately, and I agree with you totally.
    So I've just submit Add DISABLE_MODULE_SCOPE_PLUGIN option PR.

    ModuleScopePlugin restricts import file outside /src internally, therefore we could import from everywhere if you disable it.

  9. erjiang commented on Jul 13, 2021

    @erjiang

    Is it explained somewhere why the restriction on not importing things from outside src/ exists? What do the CRA maintainers recommend for sharing e.g. TypeScript files with the frontend?

  10. ryota-murakami commented on Jul 14, 2021

    @ryota-murakami
    Contributor

    @erjiang Because ModuleScopePlugin working inside webpack.
    This code block is setting on webpack config file that disable include file from outside src/.

    Original motivation is here

      // Prevents users from importing files from outside of src/ (or node_modules/).
     // This often causes confusion because we only process files within src/ with babel.
     // To fix this, we prevent you from importing files out of src/ -- if you'd like to,
     // please link the files into your node_modules/ and let module-resolution kick in.
     // Make sure your source files are compiled, as they will not be processed in any way.
    

    quote from #2189

  11. sculpt0r commented on Aug 19, 2021

    @sculpt0r

    I have a repo with structure like:

    -- frontend-app1
    |
    --frontend-app2
    |
    --domain
    |
    ----some common logic

    With above setup I want to work on both apps with shared logics inside domain directory. It would be hard to rebuild this logic and setup it as package, then install from package manager in both apps - just to have it in node_modules directory.

    Is there any chance that this option will be at least considered?

  12. bluenote10 commented on Aug 19, 2021

    @bluenote10
    Author

    It should be noted that this TypeScript issue is a bit of a showstopper for enabling imports outside src.

    Basically TypeScript has a bug (or design limitation?) that allows it to import from a "foreign" node_modules folder. This can have nasty consequences: For instance you forget to specify dependency foo in your package.json in your "frontend-app1". But in "frontend-app1" you make an import to "domain" which uses foo. If "domain" contains a node_modules folder TypeScript may accidentally use foo from there. I.e., you can end up in situations where the dependencies in "frontend-app1" are incomplete without realizing. Or it could cause headaches, because you assume you're using version X as specified in the local package.json but you're rather using version Y from that foreign node_modules.

    Ideally that TypeScript issue should be fixed first to allow for sensible cross-folder imports.

  13. sculpt0r commented on Aug 19, 2021

    @sculpt0r

    For instance you forget to specify dependency foo in your package.json in your "frontend-app1". But in "frontend-app1" you make an import to "domain" which uses foo. If "domain" contains a node_modules folder TypeScript may accidentally use foo from there. I.e., you can end up in situations where the dependencies in "frontend-app1" are incomplete without realizing. Or it could cause headaches, because you assume you're using version X as specified in the local package.json but you're rather using version Y from that foreign node_modules.

    That actually sounds like a good argument. However, there could be an easier way to tell TS that I eventually want to hurt myself and import something outside src directory.

  14. 3 remaining items

  15. norayr93 commented on Apr 22, 2022

    @norayr93

    @lingdocs Only removing that part will not solve the issue as I am struggling a few days to come up with a solution.

  16. Bhavana1233 commented on Jun 16, 2022

    @Bhavana1233

    +1, typescript should be enabled for outside the src folder by default. Or at least there has to be a way to import typescript dependencies by relative path in package.json - which seems to be currently impossible to do, without ejecting and pretty much losing any benefit of cra.

      "dependencies": {
        "@mycore-ui": "file:./../mycore-ui"
       }
    

    I'd think this should work even if the mycore dependency above is in written in typescript

    no its not working for me

  17. Bhavana1233 commented on Jun 16, 2022

    @Bhavana1233

    import {
    CommerceContextProvider,
    PrimeCatalogContainer,
    PrimeCommunityBoardList,
    PrimeCommunityBoardPage,
    PrimeInstancePage,
    PrimeNotificationContainer,
    PrimeTrainingPage,
    } from "@almLib/almLib";
    here @almLib is declared in package.json
    and still shows error
    My goal is to access components from almLib which is outside of src

  18. nikodunk commented on Jul 3, 2022

    @nikodunk

    @ttaranov solution works well in 2022 for sharing a common logic folder between react and react-native projects in the same repo. Only JS and no JSX in there though - not sure if that would work. Thank you for this hack! Super valuable to stay on create-react-app.

    Please note that this will copy your shared directory to node_modules, so changes to this directory are not reflected. We ended up not using this solution.

  19. cristiantobol commented on Jul 25, 2022

    @cristiantobol

    @erjiang Because ModuleScopePlugin working inside webpack. This code block is setting on webpack config file that disable include file from outside src/.

    Original motivation is here

      // Prevents users from importing files from outside of src/ (or node_modules/).
     // This often causes confusion because we only process files within src/ with babel.
     // To fix this, we prevent you from importing files out of src/ -- if you'd like to,
     // please link the files into your node_modules/ and let module-resolution kick in.
     // Make sure your source files are compiled, as they will not be processed in any way.
    

    quote from #2189

    This sounds like a joke. What if we want to reference a file that doesn't need any babel processing? Also, it sounds dumb to use eject solution only for this.

  20. thomasgauvin commented on Sep 1, 2022

    @thomasgauvin

    I am also encountering similar issues to others in the threads, and the hacky solutions proposed did not work for me. This is definitely an important ask

  21. Ezekias1337 commented on Oct 27, 2022

    @Ezekias1337

    I am currently working on an app using Electron and React.

    I am in a situation right now where I have several enums and other data/functions that need to be shared between the src and electron folders, but this is not possible.

    This has led to me copy pasting the same data/functions to separate directories and having to update both when a change is made. Horrendous.

  22. kleydon commented on Nov 19, 2022

    @kleydon

    +1.
    Significant limitation of CRA; looking forward to a resolution.

  23. lbfalvy commented on Nov 19, 2022

    @lbfalvy

    I just tried doing a whole project in Vite and it does this perfectly among other things, if you want a lightweight OOTB-usable framework for React that has hot reload and produces static assets I think it's the reasonable choice.

  24. pegasusdesignsystem commented on Nov 20, 2022

    @pegasusdesignsystem

    When is this change going to be made to allow outside of /src? Any ETA?

  25. emanuelecaurio commented on Dec 14, 2022

    @emanuelecaurio

    Hi guys I don't know if this might be helpful to you, but I published this npm package so I could "inject" the code inside a CRA project rather than eject itself.
    This solution has few issues though:

    1. I lose the hot-reload of the component I want to inject. I had to build everytime I make a change (or I could work inside the lib folder for small changes, then rewrite them into the ouside folder "src"),
    2. [less important] If there are any other files (such as .svg) inside the src, I had to specify inside the "build" script.
      The main problem was the hot-reload for me. That's why I was searching for other solutions. But maybe this solution can help someone
  26. dmoughabghab commented on Mar 6, 2023

    @dmoughabghab

    I just tried doing a whole project in Vite and it does this perfectly among other things, if you want a lightweight OOTB-usable framework for React that has hot reload and produces static assets I think it's the reasonable choice.

    This reply helped a lot, seems the world is moving away from create react app, this works by default in Vite

  27. pegasusdesignsystem commented on Aug 1, 2023

    @pegasusdesignsystem
  28. KrunalParmar85 commented on Nov 29, 2023

    @KrunalParmar85

    I am having similar issue, but it occurs only when I build application from Linux container. When I build from my local widow machine it works fine.

    is it some environment issue?

    Also how does it allow us to import controls from node_modules folder which is outside SRC directory as well.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions