Inspired by Chris Ferdinandi's How I structure my vanilla JS projects, all JavaScript is found within assets-src/js.
Individual files in this directory are minified into files of the same name, but are kept separate from the main JavaScript file. They are typically used only on specific pages.
This directory also contains the following subdirectories:
Contains code that is used on most/all pages across a website. Each distinct piece of functionality is held within its own file. When Amplify's JS build script is run, these files are concatenated together into web/dist/js/main.js and web/dist/js/main.min.js, which is loaded everywhere.
Contains Amplify's implementations for any third party scripts that are imported from NPM, such as accessible auto-complete.
Webpack is used to compile, transpile and minify JavaScript files. There is a webpack.config.js file in the project root which controls this process.
@TODO: add notes about Babel setup and transpiling from the browserslist in package.json.