QR Code Generator — szybkie i proste generowanie kodów QR (PWA)
Informacja: część treści powstała z użyciem narzędzi AI.
Czym jest ten projekt?
QR Code Generator to lekka aplikacja webowa umożliwiająca szybkie wygenerowanie kodu QR z dowolnego adresu URL. Projekt dostarcza prosty formularz, podgląd wygenerowanego obrazu oraz możliwość pobrania kodu w formacie PNG. Dodatkowo repo zawiera narzędzie do tworzenia ikon PWA (rozmiary 192×192 i 512×512).
Główne funkcje
Aplikacja oferuje m.in.: generowanie kodów QR z pola URL, opcjonalne etykiety (label), podgląd obrazu w przeglądarce, przycisk pobierania PNG, gotowy manifest PWA z ikonami oraz prosty kreator ikon oparty na canvas. Interfejs jest responsywny i stylizowany z wykorzystaniem przyjaznych kolorów i gradientów.
Jak to działa?
Użytkownik wprowadza adres URL w formularzu i wysyła żądanie do endpointu /generate. Serwer generuje obraz kodu QR i zapisuje go w katalogu static, a następnie zwraca stronę z podglądem oraz linkiem do pobrania. Kreator ikon rysuje tło i elementy na canvasie i pozwala pobrać gotowe pliki ikon.
Technologie i struktura
Projekt oparty jest na prostym backendzie (Flask/Python) i front-endzie HTML/CSS/JS. W repo znajdują się: szablony Jinja2 w templates/, pliki statyczne w static/ (style.css, manifest.json, ikony) oraz pomocnicze strony, np. generate_icons.html. Dzięki manifest.json aplikacja jest przygotowana do zachowania się jak PWA (theme-color i ikony).
Możliwości dostosowania
Stylesheet zawiera zmienne CSS (np. –primary-color, –success-color) oraz gradient tła (#667eea → #764ba2) i kolor akcentu (#4CAF50), co ułatwia szybką zmianę wyglądu. Możesz zmienić kolory, rozmiary ikon, lub dostosować generowanie kodu QR (np. gęstość, marginesy) w zależności od potrzeb.
Wdrażanie i użycie
Aplikację można uruchomić lokalnie (uruchomienie serwera Flask) i wdrożyć na dowolnym hostingu obsługującym WSGI. Pliki statyczne (w tym wygenerowane kody QR i ikony) znajdują się w katalogu static/ i są gotowe do serwowania przez serwer WWW. W README repo znajdziesz instrukcje uruchomienia i wymagania.
Wkład i licencja
Jeśli chcesz pomóc — otwieraj Issues i Pull Requesty. Przydatne zmiany to: testy, obsługa większej liczby formatów obrazów, lepsze opcje konfiguracyjne generowania QR oraz dodanie CI. Zachęcam do forka, zgłoszeń błędów i proponowania poprawek.
Podsumowanie
QR Code Generator to praktyczne narzędzie do szybkiego tworzenia kodów QR i ikon PWA — idealne do integracji w małych projektach, landingach czy narzędziach administracyjnych. Repozytorium jest lekkie, czytelne i łatwe do rozbudowy.
Sprawdź repozytorium: https://bit.ly/qrrgenrepo oraz profil autora: https://bit.ly/qrrgenrepo.
Szczegóły dotyczące użycia AI
AI assistance: Yes
Tool(s): GitHub Copilot, ChatGPT
Used for: Initial code skeleton and test suggestions; final implementation and tests were reviewed and edited by me.
Uwaga: AI posłużyło jako wsparcie. Końcowa weryfikacja, korekta i zatwierdzenie treści zostały wykonane ręcznie przez autora.
Zasubskrybuj i wesprzyj rozwój
⭐ Star / Fork na GitHub