Kitten

The development reload loop

Sequence Diagram from the Technical Manual.

The development reload loop

Text version

  1. Open page (kitten-hot-reload-1.js) to /🐱/development-socket/ (worker): connect
  2. /🐱/development-socket/ (worker) to Open page (kitten-hot-reload-1.js): kitten-development-boot-id (A)
  3. Developer’s editor to Files watcher (worker): save a file in the project
  4. Files watcher (worker) to Routes.handleFileChange() (worker): file event
  5. Routes.handleFileChange() (worker) to Kitten Process Manager: process.exit(99), the restart request code
  6. /🐱/development-socket/ (worker) to Open page (kitten-hot-reload-1.js): socket closes
  7. Open page (kitten-hot-reload-1.js): try to connect again 50 ms after each close
  8. If: app points at a newly installed Kitten version
    1. Kitten Process Manager: run that version’s launcher (execve app/kitten)
  9. Otherwise
    1. Kitten Process Manager: cluster.fork() a new worker
  10. Open page (kitten-hot-reload-1.js) to /🐱/development-socket/ (worker): connect
  11. /🐱/development-socket/ (worker) to Open page (kitten-hot-reload-1.js): kitten-development-boot-id (B)
  12. Open page (kitten-hot-reload-1.js): boot id changed, so window.location.reload()

Like this? Fund us!

Small Technology Foundation is a tiny, independent not-for-profit.

We exist in part thanks to patronage by people like you. If you share our vision and want to support our work, please become a patron or donate to us today and help us continue to exist.