@degreesign/webapp 1.7.5 → 1.7.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -8
- package/package.json +8 -2
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @degreesign/webapp
|
|
2
2
|
|
|
3
|
-
**
|
|
3
|
+
**A TypeScript-first development standard for building a webapp — production-ready Progressive Web Apps and Node.js servers in pure HTML, CSS and TypeScript, engineered for the fastest possible renders and sub-second page loads; one config generates optimized bundles, SEO meta tags, a PWA manifest, service worker, `sitemap.xml`, `robots.txt`, `.htaccess` and optional JavaScript obfuscation.**
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@degreesign/webapp)
|
|
6
6
|
[](https://www.npmjs.com/package/@degreesign/webapp)
|
|
@@ -25,19 +25,19 @@
|
|
|
25
25
|
|
|
26
26
|
## What is @degreesign/webapp?
|
|
27
27
|
|
|
28
|
-
`@degreesign/webapp`
|
|
28
|
+
`@degreesign/webapp` defines a **TypeScript-first development standard** for shipping **Progressive Web Apps (PWAs)** and **Node.js server bundles** from a single `build()` call: it is a small, dependency-light Webpack and TypeScript toolkit for building a webapp from **pure HTML, CSS and TypeScript**, with no framework runtime to ship or hydrate, so first render is immediate and page loads stay sub-second. Instead of hand-writing hundreds of lines of Webpack config, you pass one typed config object and get a production-ready build: TypeScript compilation, CSS extraction and inlining, asset copying, HTML templating, SEO and Open Graph/Twitter meta tags, `app.json` manifest, auto-registered service worker, sitemap, `robots.txt`, `.htaccess` security policies, bundle analysis and optional code obfuscation. It is a build-time developer tool — it runs in Node.js during your build, not in the browser.
|
|
29
29
|
|
|
30
30
|
## Why @degreesign/webapp?
|
|
31
31
|
|
|
32
32
|
- **One config, whole build** — a single typed object replaces a full `webpack.config.ts` with plugins, loaders and rules.
|
|
33
33
|
- **PWA out of the box** — generates the web app manifest, service worker, icons, orientation and install metadata automatically.
|
|
34
34
|
- **SEO built in** — per-page title, description, canonical URL, Open Graph, Twitter Cards, `robots.txt` and `sitemap.xml`.
|
|
35
|
-
- **
|
|
35
|
+
- **Typed configuration** — ships type definitions and typed configuration (`ConfigBuild`, `Page`, `PreconnectLink`).
|
|
36
36
|
- **Web and server bundling** — build the front-end to `public_html/` and the Node.js back-end to `server_build/` from the same package.
|
|
37
37
|
- **Performance defaults** — Terser minification, CSS minification, tree-shaking, content hashing and a 2 MB asset budget (configurable).
|
|
38
38
|
- **Optional obfuscation** — toggle `obfuscateON` to protect shipped JavaScript with `webpack-obfuscator`.
|
|
39
39
|
- **Secure by default** — emits `.htaccess` with HSTS, `X-Frame-Options`, Referrer-Policy, Permissions-Policy and HTTPS redirects.
|
|
40
|
-
- **
|
|
40
|
+
- **Pure HTML + CSS + TypeScript** — no framework runtime, hydration or virtual DOM to download; pages are generated as real markup at build time for the fastest possible first paint and sub-second page loads.
|
|
41
41
|
- **MIT licensed and free forever.**
|
|
42
42
|
|
|
43
43
|
## Installation
|
|
@@ -285,7 +285,7 @@ Additional public types `ConfigBuild`, `ConfigBase`, `ConfigWebApp`, `ConfigServ
|
|
|
285
285
|
## FAQ
|
|
286
286
|
|
|
287
287
|
**What is `@degreesign/webapp`?**
|
|
288
|
-
A Webpack + TypeScript build toolkit that turns one typed config object into a production-ready Progressive Web App and/or Node.js server bundle, including SEO metadata, a PWA manifest, service worker, sitemap and security headers.
|
|
288
|
+
A TypeScript-first Webpack + TypeScript build toolkit that turns one typed config object into a production-ready webapp — a Progressive Web App built from pure HTML, CSS and TypeScript — and/or a Node.js server bundle, including SEO metadata, a PWA manifest, service worker, sitemap and security headers.
|
|
289
289
|
|
|
290
290
|
**Is it free?**
|
|
291
291
|
Yes. It is open source under the MIT License and free to use in personal and commercial projects.
|
|
@@ -299,8 +299,8 @@ Yes. It wraps and configures Webpack plugins such as `terser-webpack-plugin`, `c
|
|
|
299
299
|
**Does it support TypeScript?**
|
|
300
300
|
Yes. It ships type definitions, compiles TypeScript via `ts-loader`, and exposes fully typed configuration (`ConfigBuild`, `ConfigWebApp`, `ConfigServer`, `Page`, `PreconnectLink`).
|
|
301
301
|
|
|
302
|
-
**
|
|
303
|
-
|
|
302
|
+
**How are pages built?**
|
|
303
|
+
Each page is an `.html` fragment plus a same-named `.ts` entry, styled by CSS, compiled to real markup at build time. There is no UI runtime to ship or hydrate, so first render is immediate. The package handles bundling, assets, PWA and SEO concerns rather than UI.
|
|
304
304
|
|
|
305
305
|
**Can I use it for a Node.js back-end?**
|
|
306
306
|
Yes. Set `type: "server"` with `filesList` to bundle one or more Node.js entry files, with `node_modules` externalized by default.
|
|
@@ -313,7 +313,7 @@ Web builds default to `public_html/` and server builds to `server_build/`; both
|
|
|
313
313
|
|
|
314
314
|
## Keywords
|
|
315
315
|
|
|
316
|
-
webpack, webpack config, webpack 5, typescript, ts-loader, progressive web app, PWA, web app, PWA boilerplate, web app template, build tool, bundler, node.js server bundling, SEO, meta tags, open graph, twitter cards, sitemap, robots.txt, service worker, web manifest, app manifest, code obfuscation, webpack-bundle-analyzer, static site, front-end build, degreesign.
|
|
316
|
+
webpack, webpack config, webpack 5, typescript, ts-loader, progressive web app, PWA, webapp, web app, webapp boilerplate, PWA boilerplate, web app template, build tool, bundler, node.js server bundling, SEO, meta tags, open graph, twitter cards, sitemap, robots.txt, service worker, web manifest, app manifest, code obfuscation, webpack-bundle-analyzer, static site, front-end build, degreesign.
|
|
317
317
|
|
|
318
318
|
## License
|
|
319
319
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"license": "MIT",
|
|
3
3
|
"name": "@degreesign/webapp",
|
|
4
|
-
"version": "1.7.
|
|
4
|
+
"version": "1.7.6",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"module": "dist/index.js",
|
|
7
7
|
"types": "dist/index.d.ts",
|
|
@@ -36,6 +36,12 @@
|
|
|
36
36
|
"webpack-bundle-analyzer",
|
|
37
37
|
"static-site",
|
|
38
38
|
"front-end-build",
|
|
39
|
+
"webapp",
|
|
40
|
+
"webapp-template",
|
|
41
|
+
"webapp-boilerplate",
|
|
42
|
+
"typescript-first",
|
|
43
|
+
"development-standard",
|
|
44
|
+
"performance",
|
|
39
45
|
"degreesign"
|
|
40
46
|
],
|
|
41
47
|
"repository": {
|
|
@@ -44,7 +50,7 @@
|
|
|
44
50
|
},
|
|
45
51
|
"author": "DegreeSign",
|
|
46
52
|
"homepage": "https://degreesign.com",
|
|
47
|
-
"description": "
|
|
53
|
+
"description": "TypeScript-first development standard for building a webapp — production-ready Progressive Web Apps (PWA) and Node.js servers from pure HTML, CSS and TypeScript, engineered for the fastest possible renders and sub-second page loads, generating SEO meta tags, manifest, service worker, sitemap and obfuscation from one config.",
|
|
48
54
|
"bugs": {
|
|
49
55
|
"url": "https://github.com/DegreeSign/ds_webapp/issues"
|
|
50
56
|
},
|