♻️ Use FASTAPI_ENV for development (#2427)

## AI Disclaimer

Using Codex with gpt-5.6-sol. Reviewed manually.

Author: tiangolo

.env

@@ -1,5 +1,5 @@
-# Enable local-only development behavior
-ENVIRONMENT=local
+# Enable development behavior for commands that import the app directly
+FASTAPI_ENV=development
 
 PROJECT_NAME="Full Stack FastAPI Project"
 

backend/app/api/main.py

@@ -10,5 +10,5 @@
 api_router.include_router(items.router)
 
 
-if settings.ENVIRONMENT == "local":
+if settings.FASTAPI_ENV == "development":
     api_router.include_router(private.router)

backend/app/core/config.py

@@ -33,7 +33,7 @@ class Settings(BaseSettings):
     # 60 minutes * 24 hours * 8 days = 8 days
     ACCESS_TOKEN_EXPIRE_MINUTES: int = 60 * 24 * 8
     FRONTEND_HOST: str = "http://localhost:5173"
-    ENVIRONMENT: Literal["local"] | None = None
+    FASTAPI_ENV: Literal["development"] | None = None
 
     BACKEND_CORS_ORIGINS: Annotated[
         list[AnyUrl] | str, BeforeValidator(parse_cors)
@@ -98,7 +98,7 @@ def _check_default_secret(self, var_name: str, value: str | None) -> None:
                 f'The value of {var_name} is "changethis", '
                 "for security, please change it, at least for deployments."
             )
-            if self.ENVIRONMENT == "local":
+            if self.FASTAPI_ENV == "development":
                 warnings.warn(message, stacklevel=1)
             else:
                 raise ValueError(message)

backend/app/main.py

@@ -15,7 +15,7 @@ def custom_generate_unique_id(route: APIRoute) -> str:
     return f"{route.tags[0]}-{route.name}"
 
 
-if settings.SENTRY_DSN and settings.ENVIRONMENT != "local":
+if settings.SENTRY_DSN and settings.FASTAPI_ENV != "development":
     sentry_sdk.init(dsn=str(settings.SENTRY_DSN), enable_tracing=True)
 
 app = FastAPI(

compose.override.yml

@@ -67,7 +67,7 @@ services:
     volumes:
       - ./backend/htmlcov:/app/backend/htmlcov
     environment:
-      ENVIRONMENT: "local"
+      FASTAPI_ENV: "development"
       SMTP_HOST: "mailcatcher"
       SMTP_PORT: "1025"
       SMTP_TLS: "false"