About static-import
A development skill explaining JavaScript static imports, their effect on the initial bundle, and when dynamic imports may be appropriate. It is for web developers weighing initial rendering needs against loading costs.
Key features
- 01Explains when static imports execute
- 02Describes inclusion in the initial bundle
- 03Distinguishes critical and deferred modules
Use cases
- 01Choose modules needed for the initial render
- 02Assess static imports' effect on bundle size
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ patternsdev/ skills --skill static-importAfter installing, type/static-importin Claude Code to confirm it loaded.
Details
From the project READMEStatic Import
The import keyword allows us to import code that has been exported by another module. By default, all modules we're statically importing get added to the initial bundle. A module that is imported by using the default ES2015 import syntax, import module from 'module', is statically imported.
Let's look at an example! A simple chat app contains a Chat component, in which we're statically importing and rendering three components: UserProfile, a ChatList, and a ChatInput to type and send messages! Within the ChatInput module, we're statically importing an EmojiPicker component to be able to show the user the emoji picker when the user toggles the emoji.
When to Use
- Use this for importing modules that are needed immediately on page load
- This is the default import mechanism — understand it to know when to switch to dynamic imports
Instructions
- Use static imports for modules critical to the initial render
- Be aware that all statically imported modules are bundled into the initial bundle
- Consider switching to dynamic imports for modules not needed on initial render
Details
The modules get executed as soon as the engine reaches the line on which we import them.
Since the components were statically imported, Webpack bundled the modules into the initial bundle:
Asset Size Chunks Chunk Names
main.bundle.js 1.5 MiB main [emitted] main
Our chat application's source code gets bundled into one bundle: main.bundle.js. A large bundle size can affect the loading time of our application significantly depending on the user's device and network connection. Before the App component is able to render its contents to the user's screen, it first has to load and parse all modules.
Luckily, there are many ways to speed up the loading time! We don't always have to import all modules at once: maybe there are some modules that should only get rendered based on user interaction, like the EmojiPicker in this case, or rendered further down the page. Instead of importing all component statically, we can dynamically import the modules after the App component has rendered its contents and the user is able to interact with our application.