=== SproutOS — Source Code & Build Information ===

SproutOS is open source (GPLv2 or later). This file documents where the
human-readable source for every compiled/minified asset in the plugin lives,
and how to regenerate those compiled files. Nothing in this plugin is
obfuscated.


== 1. Public source repository ==

The full, human-readable source is maintained publicly at:

https://github.com/posimyth/sproutos/tree/sproutos-source

We keep this repository updated alongside every release. Feel free to review,
study, fork, or modify the code there.


== 2. Compiled JavaScript (admin dashboard) ==

The React admin dashboard is the only part of the plugin that is compiled. Only
the compiled bundle ships in this plugin; the complete un-minified source and
the build configuration live in the public repository listed in section 1.

Compiled file (ships in plugin)   Source (in the repository)
-------------------------------   --------------------------------------------
build/index.js                    src/  (entry: src/index.js)
build/index.asset.php             generated by the build (dependency + version map)

No CSS is compiled: the dashboard is styled by the plain, un-minified
stylesheet sprout-ui/admin-design-system.css (and sprout-core/assets/css/*.css),
which ship as source and are enqueued directly.

Build tool:   @wordpress/scripts ( https://www.npmjs.com/package/@wordpress/scripts )
Build config: webpack.config.js , package.json  (in the repository)

Build steps (clone the repository, then from its root run):

    npm install
    npm run build

This produces the exact build/index.js and build/index.asset.php shipped here.


== 3. Third-party libraries bundled in the compiled JavaScript ==

The following third-party libraries are compiled into build/index.js. Their
original, un-minified source is available at the links below:

1. react-router-dom 6.30.4 — MIT license
   https://github.com/remix-run/react-router
   ( client-side routing between the dashboard tabs; includes react-router
     6.30.4 and @remix-run/router 1.23.3, both MIT )

2. axios 1.17.0 — MIT license
   https://github.com/axios/axios
   ( HTTP client used for admin-ajax.php requests )

react, react-dom, and react/jsx-runtime are NOT bundled — they are provided by
WordPress core and loaded as registered script dependencies (see
build/index.asset.php).

== 5. PHP and other JavaScript ==

All PHP (plugin root, sprout-core/, sprout-ui/) is plain, un-obfuscated source
and requires no build step.

The JavaScript at sprout-core/assets/js/sproutos-admin.js is hand-written,
un-minified source and is used directly — it is not generated by any build
tool.


== Contact ==

If you need access to any source file you cannot find inside the plugin or the
repository above, contact us and we will be happy to assist.
