nodefony-dev

Guides end-to-end development tasks in Nodefony applications using generators, inspection commands, and installed documentation search.

Updated Dec 19, 2023
One-click install
npx skills add https://github.com/nodefony/nodefony-core --skill nodefony-dev-nodefony
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nodefony-dev
Source: https://github.com/nodefony/nodefony-core/tree/main/src/packages/%40nodefony/devkit/skills/nodefony-dev
Command: npx skills add https://github.com/nodefony/nodefony-core --skill nodefony-dev-nodefony

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Developing in a Nodefony application fails when agents invent code instead of generating it, miss documentation hidden inside node_modules, or skip verification steps. This Skill orchestrates the full development workflow — understanding existing code, choosing the right facade, generating rather than hand-writing, and proving the change works — while routing specialized tasks to their dedicated skills. ## Core Features & Use Cases - Task Routing: A dispatch table directs specialized work (CRUD resources, services, realtime channels, route guards, schema migrations, browser checks) to the correct dedicated skill before any code is written. - Installed Documentation Search: The bundled docs.mjs script searches the 70+ pages of documentation shipped inside node_modules that ordinary grep cannot see, returning exact file paths and line numbers with meaningful exit codes. - Server and Frontend Pitfall Catalog: Documents measured failure modes — stale dist/ builds, undeclared classes, unbounded queries, unhandled promise rejections, event-loop blocking, XSS sinks, and Vite cache staleness — each with its fix. - Use Case: An agent asked to add a feature first inspects real routes and services with npx nodefony inspect, searches installed docs for the relevant facade, runs the appropriate generator with --dry-run, then proves the change with npm run verify. ## Quick Start Ask the agent to start a development task in this Nodefony application and it will load this skill first, route to any specialized skill needed, and verify the result before declaring it done.

Frequently Asked Questions about nodefony-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a development task in a Nodefony application?

Load the nodefony-dev skill before writing any code. It routes specialized tasks (CRUD, services, realtime channels, route guards, migrations) to dedicated skills, then drives the general workflow: inspect the running app, search installed docs, generate code, and verify.

How do I search Nodefony documentation installed in node_modules?

Run the docs.mjs script with search terms, for example `node node_modules/@nodefony/devkit/skills/nodefony-dev/scripts/docs.mjs session cookie`. It returns matching pages with exact file paths and line numbers, and supports --list, --open, and --json modes.

Why does my Nodefony route return 404 even though it exists in the source?

The runtime loads the compiled dist/ directory, not the source files, so a missing build is the most common cause. Run `npm run build`, and check that the controller is declared in the module's @controllers array, which `npx nodefony doctor` can identify.

What does exit code 78 from the docs search script mean?

Exit code 78 means no Nodefony documentation is installed, typically because dependencies have not been installed yet. Run `npm install` and retry; it does not mean the topic is undocumented.

How do I verify a change is complete in a Nodefony app?

Run `npm run verify`, which checks types, style, tests, and wiring in order and stops at the first failure. For full proof, also run `npm run test:e2e` for real boot and HTTP/WebSocket coverage, and state explicitly which checks were not run.

When should I use a specialized Nodefony skill instead of nodefony-dev?

Use a specialized skill when the task matches one exactly: nodefony-add-crud for resources, nodefony-add-service for business logic, nodefony-add-realtime-channel for WebSocket flows, nodefony-protect-route for access control, nodefony-migrate-schema for entity changes, or nodefony-browser for screen verification.