@seip/blue-bird 0.8.0 → 0.9.0

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.
Files changed (9) hide show
  1. package/README.md +20 -1
  2. package/core/cli/init.js +1 -1
  3. package/docker/docker-compose.dev.yml +6 -6
  4. package/frontend/about.html +11 -6
  5. package/frontend/index.html +2 -2
  6. package/package.json +1 -1
  7. package/frontend/css/app.css +0 -0
  8. /package/frontend/{favicon.ico → images/favicon.ico} +0 -0
  9. /package/frontend/js/{bundle.js → tailwind.js} +0 -0
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **High-Performance Express Framework — Built for Speed, Caching, and Visual Excellence**
4
4
 
5
- ![Blue Bird Logo](https://seip25.github.io/Blue-bird/blue-bird.png)
5
+ ![Blue Bird Logo](https://seip25.github.io/Blue-bird/favicon.png)
6
6
 
7
7
  [![npm version](https://img.shields.io/npm/v/@seip/blue-bird.svg)](https://www.npmjs.com/package/@seip/blue-bird)
8
8
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -15,6 +15,25 @@ Blue Bird is a powerful, performance-first API framework built on Express. It fe
15
15
 
16
16
  ---
17
17
 
18
+ ## 🕊️ The Blue Bird Philosophy
19
+
20
+ Stop wasting time configuring CORS, security headers, database connections, and authentication flows. Blue Bird provides an opinionated, highly efficient core structure allowing you to focus on writing clean business logic. Nginx handles the static frontend directly from the filesystem, Express handles the backend APIs. Includes a preconfigured Docker stack with Nginx reverse proxy, Redis cache, and PM2 cluster scaling.
21
+
22
+ ### 🧩 Decoupled Architecture
23
+ Nginx natively serves static frontend assets and extensionless HTML pages from `frontend/`. Express owns the API layer, keeping your backend entirely focused on performance and logic.
24
+
25
+ - **Cross-Platform Versatility**: Because the Express backend API is fully decoupled from the HTML/JS/CSS frontend layer, developers can easily build and maintain multiple application targets pointing to the same core API:
26
+ - **Web Applications**: Static HTML, CSS, and client-side JS served natively by Nginx.
27
+ - **Mobile Applications**: Powered by **Capacitor**, Cordova, or React Native.
28
+ - **Desktop Applications**: Built with **Electron** or **Tauri**.
29
+ - **Strong Business Logic**: Enforces a strict separation of concerns — Nginx excels at ultra-fast static file delivery and public assets, while Express handles API routing, business rules, validation, and data operations without UI rendering overhead.
30
+ - **Lightweight Footprint**: Offloading static assets to Nginx optimizes Node.js event loop performance, resulting in extremely minimal RAM, CPU, and disk consumption under high concurrent workloads.
31
+
32
+ ### 🐳 Built-in Orchestration
33
+ Includes a comprehensive Docker Compose CLI wrapper to bootstrap, build, stop, and clean dev and production environments with zero manual scripting.
34
+
35
+ ---
36
+
18
37
  ## 🚀 Key Features / Características Clave
19
38
 
20
39
  - All-In-One: Pre-configured Express API server with JSON, URL encoding, Cookies, and CORS.
package/core/cli/init.js CHANGED
@@ -1,4 +1,4 @@
1
- #!/usr/bin/env node
1
+ #!/usr/bin/env node
2
2
 
3
3
  import fs from "node:fs";
4
4
  import path from "node:path";
package/docker/docker-compose.dev.yml CHANGED
@@ -1,6 +1,6 @@
1
- services:
2
- app:
3
- command: ["npm", "run", "dev"]
4
- environment:
5
- - NODE_ENV=development
6
- - DEBUG=true
1
+ services:
2
+ app:
3
+ command: ["npm", "run", "dev"]
4
+ environment:
5
+ - NODE_ENV=development
6
+ - DEBUG=true
package/frontend/about.html CHANGED
@@ -10,7 +10,7 @@
10
10
  visual elegance and performance with raw HTML and CSS.">
11
11
  <meta name="keywords" content="">
12
12
  <meta name="author" content="Seip25">
13
- <link rel="icon" href="/favicon.ico" />
13
+ <link rel="icon" href="/images/favicon.ico" />
14
14
  </head>
15
15
 
16
16
  <body class="min-h-screen bg-slate-950 text-white font-sans antialiased selection:bg-blue-500 selection:text-white">
@@ -56,10 +56,13 @@
56
56
  <article class="p-8 rounded-2xl bg-slate-900/40 border border-white/5 shadow-xl">
57
57
  <h2 class="text-2xl font-bold text-white mb-4">Our Philosophy</h2>
58
58
  <p class="text-slate-400 leading-relaxed mb-4">
59
- Blue Bird was born out of a desire for a clean, performance-first approach to web development. We believe in harnessing the raw power of Express.js and Nginx, stripping away unnecessary bloat, and providing developers with a robust foundation that just works.
59
+ Blue Bird was born out of a desire for a clean, performance-first approach to web development. We
60
+ believe in harnessing the raw power of Express.js and Nginx, stripping away unnecessary bloat, and
61
+ providing developers with a robust foundation that just works.
60
62
  </p>
61
63
  <p class="text-slate-400 leading-relaxed">
62
- By separating the static frontend delivery (handled blazingly fast by Nginx) from the dynamic API layer (powered by Express and Redis), Blue Bird achieves unparalleled performance out of the box.
64
+ By separating the static frontend delivery (handled blazingly fast by Nginx) from the dynamic API
65
+ layer (powered by Express and Redis), Blue Bird achieves unparalleled performance out of the box.
63
66
  </p>
64
67
  </article>
65
68
 
@@ -76,11 +79,13 @@
76
79
  </li>
77
80
  <li class="flex items-start">
78
81
  <span class="text-blue-500 mr-2">✓</span>
79
- <span><strong>High Performance:</strong> Redis caching for the data layer and Nginx static delivery.</span>
82
+ <span><strong>High Performance:</strong> Redis caching for the data layer and Nginx static
83
+ delivery.</span>
80
84
  </li>
81
85
  <li class="flex items-start">
82
86
  <span class="text-blue-500 mr-2">✓</span>
83
- <span><strong>Pure HTML/CSS:</strong> No bloated frontend frameworks. Write code close to the metal.</span>
87
+ <span><strong>Pure HTML/CSS:</strong> No bloated frontend frameworks. Write code close to the
88
+ metal.</span>
84
89
  </li>
85
90
  </ul>
86
91
  </article>
@@ -92,7 +97,7 @@
92
97
  <p>Powered by Blue Bird Framework. All rights reserved.</p>
93
98
  </div>
94
99
  </footer>
95
- <script src="/js/bundle.js"></script>
100
+ <script src="/js/tailwind.js"></script>
96
101
  </body>
97
102
 
98
103
  </html>
package/frontend/index.html CHANGED
@@ -10,7 +10,7 @@
10
10
  visual elegance and performance with raw HTML and CSS.">
11
11
  <meta name="keywords" content="">
12
12
  <meta name="author" content="Seip25">
13
- <link rel="icon" href="/favicon.ico" />
13
+ <link rel="icon" href="/images/favicon.ico" />
14
14
  </head>
15
15
 
16
16
  <body class="min-h-screen bg-slate-950 text-white font-sans antialiased selection:bg-blue-500 selection:text-white">
@@ -135,7 +135,7 @@
135
135
  <p>Powered by Blue Bird Framework. All rights reserved.</p>
136
136
  </div>
137
137
  </footer>
138
- <script src="/js/bundle.js"></script>
138
+ <script src="/js/tailwind.js"></script>
139
139
  </body>
140
140
 
141
141
  </html>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seip/blue-bird",
3
- "version": "0.8.0",
3
+ "version": "0.9.0",
4
4
  "description": "Express opinionated API framework with built-in JWT auth, validation, and caching",
5
5
  "type": "module",
6
6
  "exports": {
package/frontend/css/app.css DELETED
File without changes
/package/frontend/{favicon.ico → images/favicon.ico} RENAMED
File without changes
/package/frontend/js/{bundle.js → tailwind.js} RENAMED
File without changes