diff --git a/docs/LAYER_NOTES.md b/docs/LAYER_NOTES.md
new file mode 100644
index 0000000..30de44d
--- /dev/null
+++ b/docs/LAYER_NOTES.md
@@ -0,0 +1,222 @@
+# Map Layers - Implementation Notes & Documentation
+
+Personal notes and official documentation references for each map layer implementation.
+
+---
+
+## Base Layers
+
+### OpenStreetMap
+**Status:** ✅ Working  
+**Type:** XYZ Tiles  
+**URL:** `https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png`
+
+**Implementation Notes:**
+- OSM - up to zoom 20
+
+---
+
+### 🇵🇱 Polish Orthophoto (Standard Resolution)
+**Status:** ✅ Working (minor issue)
+**Type:** WMTS  
+**Service:** Polish Geoportal PZGIK/ORTO  
+**URL:** `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMTS/StandardResolution`
+
+**Implementation Notes:**
+- Polish Ortophoto stantard - ok up to zoom 19
+
+**Official Documentation:**
+- GetCapabilities WMTS: `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMTS/StandardResolution?Service=WMTS&Request=GetCapabilities`
+- GetCapabilities WMS: `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMS/StandardResolution?Service=WMS&Request=GetCapabilities`
+
+---
+
+### 🇵🇱 Polish Orthophoto (High Resolution)
+**Status:** Not Working
+**Type:** WMTS  
+**Service:** Polish Geoportal PZGIK/ORTO  
+**URL:** `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMTS/HighResolution`
+
+**Implementation Notes:**
+- Polish Ortophoto Hirez - doesnt load at all
+
+**Official Documentation:**
+- GetCapabilities WMTS: `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMTS/HighResolution?Service=WMTS&Request=GetCapabilities`
+- GetCapabilities WMS: `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMS/HighResolution?Service=WMS&Request=GetCapabilities`
+
+---
+
+### 🌍 Google Satellite
+**Status:** ✅ Working  
+**Type:** XYZ Tiles  
+**URL:** `http://mt1.google.com/vt/lyrs=s&hl=pl&x={x}&y={y}&z={z}`
+
+**Implementation Notes:**
+- Google sat - ok (20)
+
+---
+
+### 🌍 Google Hybrid
+**Status:** ✅ Working  
+**Type:** XYZ Tiles  
+**URL:** `http://mt1.google.com/vt/lyrs=y&hl=pl&x={x}&y={y}&z={z}`
+
+**Implementation Notes:**
+- Google hyb - ok (20)
+
+---
+
+### Satellite (Esri)
+**Status:** ✅ Working  
+**Type:** XYZ Tiles  
+**Service:** ArcGIS Online World Imagery  
+**URL:** `https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}`
+
+**Implementation Notes:**
+- Esri - ok (20)
+
+---
+
+### Topographic
+**Status:** ✅ Working  
+**Type:** XYZ Tiles  
+**Service:** CARTO Voyager  
+**URL:** `https://{s}.basemaps.cartocdn.com/rastertiles/voyager/{z}/{x}/{y}{r}.png`
+
+**Implementation Notes:**
+- Topo - ok (20)
+
+---
+
+## Overlay Layers - Polish Government
+
+### 📋 Polish Cadastral Data (Działki) - Server 1
+**Status:** - VERY SLOW
+**Type:** WMS 1.3.0  
+**Service:** GUGiK - Krajowa Integracja Ewidencji Gruntów  
+**URL:** `https://integracja01.gugik.gov.pl/cgi-bin/KrajowaIntegracjaEwidencjiGruntow`  
+**Opacity:** 0.8
+
+**Layers:** `powiaty,powiaty_obreby,zsin,obreby,dzialki,geoportal,numery_dzialek,budynki`
+
+**Implementation Notes:**
+- Polish cadastral data server 1 - very slow, works only up to zoom 18
+
+**Official Documentation:**
+- GetCapabilities: `https://integracja01.gugik.gov.pl/cgi-bin/KrajowaIntegracjaEwidencjiGruntow?Service=WMS&Request=GetCapabilities`
+
+
+---
+
+### 📋 Polish Cadastral Data (Działki) - Server 2
+**Status:** - VERY SLOW  
+**Type:** WMS 1.3.0  
+**Service:** GUGiK - Krajowa Integracja Ewidencji Gruntów  
+**URL:** `https://integracja.gugik.gov.pl/cgi-bin/KrajowaIntegracjaEwidencjiGruntow`  
+**Opacity:** 0.8
+
+**Layers:** `dzialki,obreby,numery_dzialek,budynki,kontury,uzytki`
+
+**Implementation Notes:**
+- Polish cadastral data server 2 - very slow, works only up to zoom 18 (this is the current official one afaik)
+
+**Official Documentation:**
+- GetCapabilities: `https://integracja.gugik.gov.pl/cgi-bin/KrajowaIntegracjaEwidencjiGruntow?Service=WMS&Request=GetCapabilities`
+
+---
+
+### 🏗️ Polish Spatial Planning
+**Status:** Not Working  
+**Type:** WMS 1.3.0  
+**Service:** Geoportal - Krajowa Integracja Miejscowych Planów Zagospodarowania Przestrzennego  
+**URL:** `https://mapy.geoportal.gov.pl/wss/ext/KrajowaIntegracjaMiejscowychPlanowZagospodarowaniaPrzestrzennego`  
+**Opacity:** 0.7
+
+**Layers:** `raster,wektor-str,wektor-lzb,wektor-pow,wektor-lin,wektor-pkt,granice`
+
+**Implementation Notes:**
+- doesnt seem to work, or is extremely slow
+
+**Official Documentation:**
+- GetCapabilities: `https://mapy.geoportal.gov.pl/wss/ext/KrajowaIntegracjaMiejscowychPlanowZagospodarowaniaPrzestrzennego?Service=WMS&Request=GetCapabilities`
+- 
+
+
+---
+
+## Overlay Layers - Utility
+
+### 🌍 Google Roads
+**Status:** ✅ Working  
+**Type:** XYZ Tiles Overlay  
+**URL:** `http://mt1.google.com/vt/lyrs=h&hl=pl&x={x}&y={y}&z={z}`  
+**Opacity:** 1.0
+
+**Implementation Notes:**
+- Ok
+
+
+
+---
+
+## Technical Notes
+
+### Coordinate Reference Systems
+- **EPSG:3857** - Web Mercator (current implementation for all layers)
+- **EPSG:2180** - Polish national projection (PUWG 1992)
+  - Some Polish services support this natively
+  - Would require proj4leaflet for proper support
+
+### WMS Version Differences
+- **WMS 1.1.1:** Uses `SRS` parameter for coordinate system
+- **WMS 1.3.0:** Uses `CRS` parameter for coordinate system
+- Current implementation auto-detects and handles both
+
+### Performance Considerations
+- 
+
+### Known Issues
+- 
+
+---
+
+## Future Enhancements
+
+### Planned
+- [ ] Dynamic opacity controls
+- [ ] Layer legends/metadata panels
+- [ ] EPSG:2180 support via proj4leaflet
+- [ ] Layer error handling with fallbacks
+- [ ] Mobile-optimized layer control
+
+### Ideas
+- 
+
+---
+
+## References & Resources
+
+### Polish Geoportal
+- Main portal: https://www.geoportal.gov.pl/
+- Service catalog: https://www.geoportal.gov.pl/uslugi
+- 
+
+### GUGiK (Główny Urząd Geodezji i Kartografii)
+- Main website: https://www.gugik.gov.pl/
+- 
+
+### LP-Portal
+- Website: https://lp-portal.pl/
+- 
+
+### Leaflet Documentation
+- WMS Layers: https://leafletjs.com/reference.html#tilelayer-wms
+- 
+
+---
+
+## Changelog
+
+### 2026-01-16
+- Created LAYER_NOTES.md for documentation and personal notes
+- Initial structure with all current layers documented