Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

node-backend-setup

/node-backend-setup

Zakłada backend Node.js z ESM, typowaną konfiguracją, łagodnym zamykaniem i ustrukturyzowanym logowaniem od początku, także przy utwardzaniu usługi rozrosłej bez fundamentów.

Repozytorium
AI-SKILLS ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.09.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zakłada backend Node.js z ESM, typowaną konfiguracją, łagodnym zamykaniem i ustrukturyzowanym logowaniem od początku, także przy utwardzaniu usługi rozrosłej bez fundamentów.

Oryginalny opis (EN)

Bootstrap a Node.js backend with ESM, typed config, graceful shutdown, and structured logging from the start. Use when starting a Node service or hardening one that grew without foundations.

Jak działa

  1. Method
  2. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 52 linii, 394 słów
Podgląd SKILL.md
---
name: node-backend-setup
description: Bootstrap a Node.js backend with ESM, typed config, graceful shutdown, and structured logging from the start. Use when starting a Node service or hardening one that grew without foundations.
---

# Node backend setup

A Node backend that starts as a quick `index.js` and grows accretes the
same missing foundations every time: no config discipline, no graceful
shutdown, console.log everywhere. Putting the foundations in at the start
costs an hour and saves a rewrite.

## Method

1. **Start with ESM and TypeScript.** `"type": "module"`, a tsconfig
   targeting your Node version (see tsconfig-mastery), and a runner
   (`tsx`/`ts-node` for dev, compiled output or a bundler like `tsup` for
   prod). Modern Node runs TypeScript-adjacent setups cleanly; pick one
   and stay consistent to avoid the module-resolution pain (see
   js-modules).
2. **Load and validate config once, typed.** Read environment variables
   at startup into a validated, typed config object (a schema validator:
   zod/envalid), failing fast with a clear message if a required var is
   missing or malformed (see environment-config, request-validation). No
   `process.env.FOO` scattered through the code; one config module every
   file imports.
3. **Implement graceful shutdown from day one.** Trap `SIGTERM`/`SIGINT`:
   stop accepting new connections, finish in-flight requests, close the
   DB pool and other resources, then exit; with a timeout that forces
   exit if drain hangs (see graceful-shutdown). Every deploy and scale-in
   sends SIGTERM; without this, each one drops requests.
4. **Use structured logging, not console.log.** A logger (pino/winston)
   emitting JSON with levels, a request/correlation id, and no secrets
   (see structured-logging, log-levels). `console.log` gives you
   unsearchable, unleveled noise the moment the service sees real traffic.
5. **Add health and readiness endpoints.** A liveness check (process is
   up) and a readiness check (dependencies reachable) so orchestrators
   route and restart correctly (see health-checks); the difference
   matters the first time a dependency blips.
6. **Handle the process-level failures.** Register `unhandledRejection`
   and `uncaughtException` handlers that log and exit cleanly (a crashed
   process is better than a zombie in a bad state; let the orchestrator
   restart it), and never leave them unset (see js-error-handling).

## Boundaries

- This is the service skeleton; the framework choice (Express, Fastify,
  Hono, Nest) and the API design sit on top (see rest-endpoint-design,
  api-design). Pick the framework for the project, but the foundations
  above are framework-independent.
- Clustering and multi-core scaling (Node uses one core per process) is a
  deployment decision (a process manager or the orchestrator running N
  replicas), usually better than the in-process `cluster` module.
- Long CPU-bound work blocks the event loop and belongs in worker threads
  or a separate service, not the request path (see js-event-loop).

Wersje

W bazie nie ma innych skilli o nazwie node-backend-setup.

Migawka bazy z 13.11.2026 · wersja paczki a91b300106ba (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100nodejs-service-foundations
    Ustawia lub utwardza podstawy usługi Node.js: walidację zmiennych środowiskowych, logowanie, typowane błędy i podpinanie wyłączania.
  • 90nodejs-service-foundations
    Ustawia lub utwardza fundamenty usługi Node.js: walidację env, logowanie, typowane błędy, type stripping i obsługę zamykania.
  • 100backend-patterns
    Pomaga budować i przeglądać serwery Node.js i TypeScript: warstwy, walidację, błędy, dostęp do danych, cache i zadania.
  • 100spine-service
    Buduje od zera nową usługę gotową do produkcji: zarządzanie konfiguracją, health checki, łagodne zamykanie i logowanie strukturalne.
  • 95hono-ts-backend
    Zakłada nowy backend TypeScript na Hono i Node: scaffolding usługi, dobre praktyki i przegląd istniejących API.
  • 100node-backend
    Buduje i unowocześnia usługi HTTP w Node.js z typowaną walidacją, własnością cyklu życia i zachowaniem produkcyjnym w Hono, Fastify, NestJS lub innym wybranym serwerze.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.