diff --git a/README.md b/README.md
index 1041f0c..7e11a5b 100644
--- a/README.md
+++ b/README.md
@@ -79,13 +79,19 @@ Run tests:
 npm test
 ```
 
+Run static checks:
+
+```bash
+npm run lint
+```
+
 Build for production:
 
 ```bash
 npm run build
 ```
 
-Preview the production build:
+Preview the production build locally:
 
 ```bash
 npm run preview
@@ -97,6 +103,8 @@ You can also use the `start` alias after building:
 npm run start
 ```
 
+For deployment, serve the generated `dist/` directory with any static web server.
+
 ## Notes
 
 MapSift uses the public Overpass API. Large viewport searches are blocked in the UI to avoid irresponsible requests. If a query returns too much data or the API is busy, zoom in, reduce filters, or try again later.
diff --git a/package.json b/package.json
index ea4d50a..0c3455e 100644
--- a/package.json
+++ b/package.json
@@ -5,6 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "vite",
+    "lint": "tsc -b --pretty false",
     "build": "tsc -b && vite build",
     "preview": "vite preview",
     "start": "vite preview",