diff --git a/readme.md b/readme.md
index 6e69216..c2fb53a 100644
--- a/readme.md
+++ b/readme.md
@@ -1,11 +1,148 @@
-Tworzenie nowego repozytorium z linii poleceń
-touch README.md
-git init
-git checkout -b main
-git add README.md
-git commit -m "first commit"
-git remote add origin https://git.wastpol.pl/admin/wtyczka-zms.git
-git push -u origin main
-Wypychanie istniejącego repozytorium z linii poleceń
-git remote add origin https://git.wastpol.pl/admin/wtyczka-zms.git
-git push -u origin main
\ No newline at end of file
+# Rozszerzenie Przeglądarki ZEDEMES 2.0
+
+Rozszerzenie Chrome integrujące się z polskimi usługami geodezyjnymi i platformami mapowymi, zapewniające rozszerzoną funkcjonalność w pracy z danymi katastralnymi, dokumentami planowania przestrzennego i różnymi dostawcami map.
+
+## Funkcje
+
+### Integracja z Dostawcami Map
+- **Geoportal** - Integracja z polskim geoportalem narodowym
+- **Google Maps** - Szybki dostęp do Google Maps z bieżącymi współrzędnymi
+- **ISOK** - System informacji o gospodarce wodnej
+- **SOPO** - System oceny ryzyka osuwisk
+- **GDOS** - Dane o ochronie środowiska
+- **LPP** - Integracja z lokalnym portalem drogowym
+
+### Funkcje Danych Przestrzennych
+- **Działki Katastralne** - Wyświetlanie granic katastralnych i numerów działek
+- **Planowanie Przestrzenne** - Nakładka MPZP (miejscowe plany zagospodarowania przestrzennego) overlay
+- **Narzędzia Pozycji** - Wyświetlanie i kopiowanie współrzędnych
+- **Profilowanie Przekrojów** - Analiza przekrojów terenu
+- **Nakładka Osuwisk** - Wizualizacja zagrożeń geologicznych
+
+### Obsługa Systemów Współrzędnych
+- EPSG:2177 (Polski system współrzędnych)
+- EPSG:2180 (PUWG 92)
+- EPSG:4326 (WGS84)
+- EPSG:3857 (Web Mercator)
+
+## Instalacja
+
+1. Sklonuj repozytorium:
+```bash
+git clone https://git.wastpol.pl/admin/wtyczka-zms.git
+```
+
+2. Otwórz Chrome i przejdź do `chrome://extensions/`
+
+3. Włącz "Tryb deweloperski" w prawym górnym rogu
+
+4. Kliknij "Załaduj rozpakowane" i wybierz katalog rozszerzenia
+
+## Struktura Projektu
+
+```
+├── manifest.json          # Manifest rozszerzenia
+├── js/
+│   ├── background.js      # Skrypt w tle
+│   ├── content.js         # Główny skrypt zawartości
+│   ├── core.js           # Funkcjonalność podstawowa
+│   ├── inject.js         # Skrypt wstrzykiwania na stronę
+│   ├── intercept.js      # Przechwytywanie żądań
+│   ├── functions/        # Implementacje funkcji
+│   │   ├── dzialki.js    # Działki katastralne
+│   │   ├── dzialki2.js   # Alternatywne źródło katastralne
+│   │   ├── lines.js      # Narzędzia linii
+│   │   ├── mpzp.js       # Planowanie przestrzenne
+│   │   ├── osuwiska.js   # Dane o osuwiskach
+│   │   ├── position.js   # Narzędzia pozycji
+│   │   ├── section.js    # Profilowanie terenu
+│   │   └── test.js       # Narzędzia testowe
+│   ├── handlers/         # Obsługa wiadomości i zdarzeń
+│   │   ├── geoButton.js  # Obsługa przycisku Geoportal
+│   │   ├── getChelmiec.js # Obsługa gminy Chełmiec
+│   │   ├── getGmina.js   # Wykrywanie gminy
+│   │   ├── messages.js   # Obsługa wiadomości
+│   │   └── translate.js  # Tłumaczenie współrzędnych
+│   └── map_providers/    # Integracje z zewnętrznymi usługami mapowymi
+│       ├── gdos.js       # Integracja z GDOS
+│       ├── geoportal.js  # Integracja z Geoportal
+│       ├── google.js     # Integracja z Google Maps
+│       ├── isok.js       # Integracja z ISOK
+│       ├── lpp.js        # Integracja z LPP
+│       └── sopo.js       # Integracja z SOPO
+├── icons/                # Ikony rozszerzenia i zasoby UI
+└── readme.md            # Ten plik
+```
+
+## Konfiguracja
+
+Rozszerzenie korzysta z API MapTiler do transformacji współrzędnych. Może być konieczne zaktualizowanie klucza API w plikach dostawców map:
+
+```javascript
+// Zaktualizuj ten klucz w plikach map_providers/*.js
+const API_KEY = "OZa2pWHGvC94xakI0fVk";
+```
+
+## Użycie
+
+1. Przejdź na obsługiwaną stronę mapową (np. `*.tauron-dystrybucja.pl`)
+2. Rozszerzenie automatycznie wstrzyknie przyciski narzędziowe dla różnych dostawców map
+3. Kliknij dowolny przycisk dostawcy, aby otworzyć bieżący zakres mapy w tej usłudze
+4. Użyj narzędzi rysowania do tworzenia profili terenu i oznaczania pozycji
+
+### Obsługiwane Gminy
+- Chełmiec
+- Łososina Dolna  
+- Nawojowa
+
+## Rozwój
+
+### Dodawanie Nowych Dostawców Map
+
+1. Utwórz nowy plik w `js/map_providers/`
+2. Zaimplementuj funkcję obsługi kliknięcia przycisku
+3. Dodaj logikę transformacji współrzędnych
+4. Zarejestruj dostawcę w `manifest.json`
+
+### Dodawanie Nowych Funkcji
+
+1. Utwórz nowy plik w `js/functions/`
+2. Zaimplementuj logikę funkcji
+3. Dodaj elementy UI w `js/handlers/messages.js`
+4. Zarejestruj w tablicy skryptów zawartości
+
+## Punkty Końcowe API
+
+Rozszerzenie integruje się z kilkoma zewnętrznymi API:
+
+- **MapTiler API** - Transformacje współrzędnych
+- **Usługi GUGIK** - Polskie dane katastralne
+- **Geoportal.gov.pl** - Usługi narodowego geoportalu
+- **Usługi PIG** - Dane Państwowego Instytutu Geologicznego
+
+## Obsługa Przeglądarek
+
+- Chrome 88+
+- Kompatybilne z Manifest V3
+
+## Licencja
+
+Ten projekt jest oprogramowaniem własnościowym opracowanym do użytku wewnętrznego.
+
+## Wkład
+
+1. Sforkuj repozytorium
+2. Utwórz gałąź funkcji
+3. Zatwierdź swoje zmiany
+4. Wypchnij do gałęzi
+5. Utwórz Pull Request
+
+## Historia Wersji
+
+- **v0.0.13** - Bieżąca wersja z rozszerzoną integracją dostawców map
+- Poprzednie wersje skupiały się na rozwoju podstawowej funkcjonalności
+
+## Kontakt
+
+W przypadku pytań lub wsparcia skontaktuj się z zespołem deweloperskim w organizacji.
+