Bug: project not starting on Mac Sequioa 15.7.3

Description

Project not running after following the exact setup steps on a Mac.

URL to code causing the issue

https://github.com/litestar-org/litestar-fullstack/

MCVE

New Litestar user here. Came across the "fullstack example" repo, and wanted to give it a try. 

I followed the exact steps in the described in the README.md to get the project running.

When running `app run`, I get the following (non-descriptive) error:

--

(litestar-fullstack) litestar-fullstack % app database upgrade

Loading environment configuration from .env
Using Litestar Fullstack Template app from env: 'app.server.asgi:create_app'
Starting database upgrade process ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Are you sure you want migrate the database to the `head` revision? [y/n]: y
2026-02-16T22:00:41.246172Z [info     ] Context impl PostgresqlImpl.  
2026-02-16T22:00:41.246308Z [info     ] Will assume transactional DDL.
2026-02-16T22:00:41.259423Z [info     ] Running upgrade  -> dc54b25d8b6c, initial
(litestar-fullstack) litestar-fullstack % app run

Loading environment configuration from .env
Using Litestar Fullstack Template app from env: 'app.server.asgi:create_app'
Starting Granian server process with uvloop ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
┌──────────────────────────────┬────────────────────────────────────────────────────────┐
│ Litestar version             │ 2.19.0                                                 │
│ Debug mode                   │ Enabled                                                │
│ Python Debugger on exception │ Disabled                                               │
│ CORS                         │ Enabled                                                │
│ CSRF                         │ Disabled                                               │
│ OpenAPI                      │ Enabled path=/schema                                   │
│ Compression                  │ Disabled                                               │
│ Middlewares                  │ JWTCookieAuthenticationMiddleware, ViteProxyMiddleware │
└──────────────────────────────┴────────────────────────────────────────────────────────┘
• Applied Vite environment variables
✓ Types exported → openapi: src/js/web/src/lib/generated/openapi.json
• Starting Vite server with HMR
✓ Vite process started
2026-02-16T22:01:07.208573Z [info     ] Starting granian (main PID: 62374)
$ vite
2026-02-16T22:01:07.236205Z [info     ] Listening at: http://0.0.0.0:8000
2026-02-16T22:01:07.242004Z [info     ] Spawning worker-1 with PID: 62631
2026-02-16T22:01:07.439169Z [error    ] Unexpected exit from worker-1 
2026-02-16T22:01:07.439544Z [info     ] Shutting down granian         
error: script "dev" was terminated by signal SIGTERM (Polite quit request)
• Vite process stopped.
--

I tried to debug it, printing configs and so on, but nothing apparent seems to be wrong. I tried searching for the "dev script", but nothing named similar or leads to something with a similar name.

Steps to reproduce

Follow the exact steps in the README.md on a Mac (Sequioa 15.7.3) to get the project running.

Screenshots

No response

Logs

Package Version

Latest as of this wring - 15th of February 2026.

Platform

• Linux
• Mac
• Windows
• Other (Please specify in the description above)

Start with README.md's setup steps and the app run entry point; reproduce on macOS 15.7.3 and trace the Granian worker's unexpected SIGTERM after Vite starts. Determine the startup failure and make the documented setup complete successfully, then verify the app remains running.