|
|
@@ -8,48 +8,48 @@
|
|
|
</head>
|
|
|
|
|
|
<body>
|
|
|
- <p>Once you start developing your own app / lib, you should
|
|
|
+ <p>Once you start developing your own app / lib / backend, you should
|
|
|
remove all unnecessary parts left from the sample app.</p>
|
|
|
<ul style="width: 40ex">
|
|
|
- <li>In <code>index.html</code>
|
|
|
- <code><body></code> tag,
|
|
|
+ <li>You can choose to polyfill less or not at all in Gruntfile.js / index.html,
|
|
|
+ as a consequence polyfilling dependencies can be uninstalled.
|
|
|
+ </li>
|
|
|
+ <li>In case you don't need webapp part at all, you can remove
|
|
|
+ deploy.js (and its appearance in testing.js), {%= name %} package,
|
|
|
+ webapp-specific dependencies in package.json
|
|
|
+ (modules silk, domite, contrib-web and contrib-jquery),
|
|
|
+ remove "start the app" call in index.html
|
|
|
+ and remove webapp-specific parts in Gruntfile.js.
|
|
|
+ </li>
|
|
|
+ <li>You should keep index.html (you need it to develop),
|
|
|
+ but in cleaned form (see below).</li>
|
|
|
+ <li>In index.html <code><body></code> tag,
|
|
|
everything should be removed, except
|
|
|
the <code><script></code> tag
|
|
|
that initializes Amber and starts your app;
|
|
|
- then you can add elements specific to your own app
|
|
|
- to the page.</li>
|
|
|
- <li>If you aren't going to use <code>Web</code>
|
|
|
- package from <code>amber-contrib-web</code> module,
|
|
|
- but want to retain the jQuery wrapper,
|
|
|
- you should run <code>npm uninstall @ambers/contrib-web --save</code>
|
|
|
- from your CLI.</li>
|
|
|
- <li>If you aren't going to use the <code>Web</code>
|
|
|
- package from the <code>amber-contrib-web</code> module,
|
|
|
- nor the jQuery wrapper from <code>amber-contrib-jquery</code>,
|
|
|
- you should run <code>npm uninstall @ambers/contrib-web @ambers/contrib-jquery --save</code>
|
|
|
- from your CLI.</li>
|
|
|
- <li>You cannot remove just the jQuery wrapper and retain the Web package,
|
|
|
- as it depends on the jQuery wrapper.</li>
|
|
|
- <li>If you aren't going to use <code>Silk</code>
|
|
|
- package from <code>silk</code> module,
|
|
|
- but want to retain <code>DOMite</code> DOM wrapper,
|
|
|
- you should run <code>npm uninstall silk --save</code>
|
|
|
- from your CLI.</li>
|
|
|
- <li>If you aren't going to use the <code>Silk</code>
|
|
|
- package from the <code>silk</code> module,
|
|
|
- nor the DOM wrapper from <code>domite</code>,
|
|
|
- you should run <code>npm uninstall silk domite --save</code>
|
|
|
- from your CLI.</li>
|
|
|
- <li>You cannot remove just the <code>DOMite</code> DOM wrapper
|
|
|
- and retain the Silk package, as it depends on <code>domite</code>.</li>
|
|
|
- <li>Your <code>Gruntfile.js</code> may contain references
|
|
|
- to <code>Web</code> and/or <code>Silk</code> in <code>libraries</code>
|
|
|
- field(s). Fix those fields to not contain non-existing libraries (optionally
|
|
|
- add other needed ones, like <code>domite</code> or <code>Wrappers-JQuery</code>).</li>
|
|
|
+ then you can add elements specific to your own webapp
|
|
|
+ to the page (or leave it bare if case in previous item happened).</li>
|
|
|
+ <li>In case you will develop the webapp part,
|
|
|
+ you will probably only use one set of libraries presented
|
|
|
+ (there are more options so you can see and choose).
|
|
|
+ So either you keep silk which depends on domite,
|
|
|
+ or you keep contrib-web which depends on contrib-jquery.
|
|
|
+ Your Gruntfile.js may contain references
|
|
|
+ to these modules in <code>libraries</code>
|
|
|
+ field(s). Fix those fields to not contain removed libraries.</li>
|
|
|
+ <li>In case you are developing an Amber library (eg. not the app),
|
|
|
+ you'll probably end up not needing any of the aformentioned libraries
|
|
|
+ (depends on how UI-heavy your library are),
|
|
|
+ and you likely can remove the intro {%= name %} class
|
|
|
+ and the "start the app" call in index.html.
|
|
|
+ </li>
|
|
|
+ <li>In case you don't need the lambda / backend part at all,
|
|
|
+ you can remove lambda.js (and its appearance in testing.js),
|
|
|
+ {%= name %}-Backend package, lambda directory
|
|
|
+ and remove lambda-specific parts of Gruntfile.js.
|
|
|
+ </li>
|
|
|
+ <li>These introductory files: parts.html and uninstall.html can be deleted.</li>
|
|
|
</ul>
|
|
|
- <p>If you are sure your app will only be run in modern browser / node.js
|
|
|
- with Promise present, you can <code>npm uninstall es6-promise --save</code>,
|
|
|
- then remove <code>es6-promise.amd.json</code> file.</p>
|
|
|
<p>As the last step, make sure the dependency tree is in a correct state
|
|
|
by recreating it: run <code>npm run reset</code> from your CLI.</p>
|
|
|
</body>
|
