nooblyjs-apps-blog
v1.0.0
Published
This repository holds the code for a micro-service that exposes a simple blog like Medium. It leverages all the NooblyJS infrastructure.
Readme
NooblyJS Blog Platform
NooblyJS Blog is a Medium-inspired publishing experience built on top of the NooblyJS Core accelerator. It combines an API-first, native Node.js backend with a Bootstrap 5 client to deliver a responsive, extensible blog for independent writers, publications, and readers.
Solution Overview
- API-first design: Every capability is exposed through JSON endpoints under
/v1/..., documented with an OpenAPI 3.1 spec. Future native apps or partner integrations consume the same APIs as the web client. - Native Node.js runtime: A lightweight HTTP server delegates to the NooblyJS Core
serviceRegistry, giving us provider-driven caching, data, logging, search, queueing, and workflow services without high-level frameworks. - Bootstrap 5 web client: Progressive enhancement with ES modules and Bootstrap Icons provides a familiar, fast UI for reading, authoring, and moderating content—no React involved.
- Extensible domain model: Posts, tags, comments, bookmarks, claps, and notifications are modeled to support scheduled publishing, analytics, and moderation from day one.
- Operational readiness: Metrics, structured logging, background jobs, and admin utilities are surfaced through the accelerator’s
/services/...endpoints with API-key protection.
Architecture Highlights
noobly-coreaccelerates common backend concerns via providers (PostgreSQL-backed data service, Redis cache, S3 media storage, BullMQ queues, etc.).- Public APIs and the Bootstrap client are decoupled; static assets live in
public/, client scripts fetch data via the documented endpoints. - Service registry initialization is environment-driven, allowing memory-backed providers in local development and managed services (PostgreSQL, Redis, S3) in production.
- Observability is handled with structured logs, Prometheus metrics exported from the measuring service, and error/event hooks wired into the registry emitter.
Documentation
- Product requirements live in
docs/nooblys-blog-prd.md, covering features, milestones, risks, and NooblyJS Core integration details. - Additional accelerator usage notes are under
.agent/architecture/nooblyjs-core-usage.md.
Status
The project is in active development. Follow the release milestones in the PRD to track upcoming capabilities (draft editor, engagement features, moderation tooling, analytics, and beyond).
