The Skypager Project Bundler is a utility that packages entire project folders, including source code, dependency mappings, version control data, component registries, configurations, tests, and documentation, into a single, 'universal-javascript friendly' package. It provides an abstraction over project files, treating them as an active record style ORM, which allows for targeted edits directly to the source code through various interfaces (UI, API, CLI) while maintaining seamless integration with Git version control. Currently stable at version 4.6.1, its release cadence is tied to the broader Skypager ecosystem. A key differentiator is its ability to serve specific 'slices' of a project on demand, minimizing the exposed surface area for editing tasks. It also wraps the Webpack compiler, providing pre-configured presets for common development setups, abstracting away much of the underlying Webpack complexity.
npm install skypager-project-bundlerVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates standalone usage of the ProjectBundler, showing how to create an instance, apply a preset, define pages, compile the project, and save the resulting bundle to disk.
Familiarize yourself with Webpack fundamentals, consult the Skypager preset documentation, and leverage Webpack's verbose logging options during compilation.
Ensure the required 'skypager-preset-*' packages are explicitly installed in your project and verify the preset name in the `Bundler.create()` options.
Always check the documentation for `skypager-preset-*` packages for their compatibility requirements. If issues arise, try aligning major versions of all Skypager-related packages and Webpack.
Always interact with the project source code through the Bundler's provided APIs or established Git workflows. Use its mechanisms for re-absorbing changes made externally.
Install `webpack` and any specific `webpack-cli`, loaders (e.g., `babel-loader`), or plugins required by your chosen preset: `npm install --save-dev webpack webpack-cli`
Use a named import: `import { ProjectBundler } from 'skypager-project-bundler'` or for CommonJS: `const { ProjectBundler } = require('skypager-project-bundler')`Ensure the corresponding preset package (e.g., `skypager-preset-bootstrap-react`) is installed: `npm install --save-dev skypager-preset-bootstrap-react` and verify the name used in `preset` option.
Double-check the import statement `import { ProjectBundler } from 'skypager-project-bundler'` and ensure `skypager-project-bundler` is installed correctly in `node_modules`.