{"id":27064811,"url":"https://github.com/marek161/apka-finansowa","last_synced_at":"2026-04-13T04:32:08.955Z","repository":{"id":286000370,"uuid":"960047112","full_name":"Marek161/Apka-Finansowa","owner":"Marek161","description":"Aplikacja Finansowa 💵","archived":false,"fork":false,"pushed_at":"2025-04-04T06:06:19.000Z","size":324,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T19:52:09.958Z","etag":null,"topics":["chartjs","context-api","firebase","jest","react","react-router","react-testing-library","redux","tailwindcss"],"latest_commit_sha":null,"homepage":"https://apka-finansowa.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Marek161.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-04-03T19:17:04.000Z","updated_at":"2025-04-04T06:06:23.000Z","dependencies_parsed_at":"2025-04-09T19:49:21.136Z","dependency_job_id":null,"html_url":"https://github.com/Marek161/Apka-Finansowa","commit_stats":null,"previous_names":["marek161/apka-finansowa"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Marek161/Apka-Finansowa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marek161%2FApka-Finansowa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marek161%2FApka-Finansowa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marek161%2FApka-Finansowa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marek161%2FApka-Finansowa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Marek161","download_url":"https://codeload.github.com/Marek161/Apka-Finansowa/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Marek161%2FApka-Finansowa/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279675676,"owners_count":26209126,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-19T02:00:07.647Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chartjs","context-api","firebase","jest","react","react-router","react-testing-library","redux","tailwindcss"],"created_at":"2025-04-05T17:19:18.424Z","updated_at":"2025-10-19T02:49:12.040Z","avatar_url":"https://github.com/Marek161.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🟢 Aplikacja Finansowa\n\nAplikacja Finansowa to nowoczesne narzędzie do zarządzania osobistymi finansami, zbudowane przy użyciu React i Firebase. Aplikacja umożliwia śledzenie przychodów i wydatków, zarządzanie budżetem oraz wizualizację danych finansowych.\n\n### ➡️  [LINK DO STRONY](https://apka-finansowa-git-master-marek161s-projects.vercel.app/login)  ⬅️\n\n![apka finansowa1](https://github.com/user-attachments/assets/30e3cf02-fa04-44be-a49d-c5e449673664)\n![apka finansowa2](https://github.com/user-attachments/assets/22af59fa-d55d-4743-a0c0-7978fac6ac9d)\n![apka finansowa3](https://github.com/user-attachments/assets/eef52f2b-7b12-4728-9d98-5a3d5b8487e7)\n\n\n\n## 🟢 Funkcjonalności\n\n- Autoryzacja użytkowników\n- Zarządzanie transakcjami (dodawanie, edytowanie, usuwanie)\n- Konfiguracja budżetu\n- Wizualizacja danych w postaci wykresów\n- Synchronizacja w czasie rzeczywistym\n- Obsługa offline\n\n## 🟢 Technologie\n\n- React 18\n- Firebase (Firestore, Authentication, Storage)\n- Tailwind CSS\n- Redux\n- Context API\n- React Router\n- Chart.js\n- Jest \u0026 React Testing Library\n\n## 🟢 Struktura projektu\n\n```\n/\n├── docs/                        # Dokumentacja projektu\n│   ├── api/                     # Dokumentacja API\n│   ├── database/                # Dokumentacja bazy danych\n│   ├── developer-guide/         # Przewodniki dla deweloperów\n│   └── user-guide/              # Instrukcje dla użytkowników\n├── public/                      # Pliki publiczne\n├── src/                         # Kod źródłowy\n│   ├── components/              # Komponenty React\n│   │   ├── common/              # Wspólne komponenty\n│   │   ├── dashboard/           # Komponenty pulpitu\n│   │   ├── layout/              # Komponenty układu strony\n│   │   ├── layouts/             # Alternatywne układy stron\n│   │   ├── transactions/        # Komponenty transakcji\n│   │   ├── calendar/            # Komponenty kalendarza\n│   │   ├── DashboardCharts.jsx  # Wykresy na pulpicie\n│   │   ├── DashboardSummary.jsx # Podsumowanie na pulpicie\n│   │   ├── DevelopmentHelper.jsx# Pomocnik trybu deweloperskiego\n│   │   ├── FirebaseIndexHelper.jsx # Pomocnik dla indeksów Firebase\n│   │   ├── Layout.jsx           # Główny układ aplikacji\n│   │   ├── LoadingScreen.jsx    # Ekran ładowania\n│   │   ├── Notifications.jsx    # Komponent powiadomień\n│   │   ├── PrivateRoute.jsx     # Komponent chronionej ścieżki\n│   │   ├── ProtectedRoute.jsx   # Komponent chronionej trasy\n│   │   ├── RecentTransactions.jsx # Ostatnie transakcje\n│   │   └── Sidebar.jsx          # Pasek boczny\n│   ├── contexts/                # Konteksty React\n│   │   ├── AuthContext.jsx      # Kontekst autoryzacji\n│   │   ├── BudgetContext.jsx    # Kontekst budżetu\n│   │   ├── NotificationsContext.jsx # Kontekst powiadomień\n│   │   └── ThemeContext.jsx     # Kontekst motywu\n│   ├── layouts/                 # Układy stron\n│   ├── pages/                   # Strony aplikacji\n│   │   ├── Auth/                # Strony autoryzacji\n│   │   ├── Budget/              # Strony budżetu\n│   │   ├── Transactions/        # Strony transakcji\n│   │   ├── Budget.jsx           # Główna strona budżetu\n│   │   ├── Dashboard.jsx        # Pulpit główny\n│   │   ├── ErrorPage.jsx        # Strona błędu\n│   │   ├── ForgotPassword.jsx   # Odzyskiwanie hasła\n│   │   ├── Login.jsx            # Logowanie\n│   │   ├── NotFound.jsx         # Strona 404\n│   │   ├── Register.jsx         # Rejestracja\n│   │   ├── Settings.jsx         # Ustawienia\n│   │   └── Transactions.jsx     # Strona transakcji\n│   ├── services/                # Serwisy aplikacji\n│   ├── store/                   # Stan Redux\n│   ├── utils/                   # Funkcje pomocnicze\n│   ├── App.js                   # Główny komponent aplikacji\n│   ├── App.jsx                  # Alternatywny komponent główny\n│   ├── firebase.js              # Konfiguracja Firebase\n│   ├── index.css                # Główny plik CSS\n│   ├── index.js                 # Punkt wejściowy aplikacji\n│   ├── reportWebVitals.js       # Raportowanie wydajności\n│   ├── serviceWorker.js         # Service Worker dla PWA\n│   └── tailwind.css             # Style Tailwind\n├── README.md                    # Dokumentacja projektu\n├── craco.config.js              # Konfiguracja Create React App\n├── package.json                 # Konfiguracja projektu\n├── postcss.config.js            # Konfiguracja PostCSS\n├── prepare-commit.sh            # Skrypt pomocniczy Git\n└── tailwind.config.js           # Konfiguracja Tailwind CSS\n```\n\n\n## 🟢 Instalacja i uruchomienie\n\n1. Sklonuj repozytorium\n2. Zainstaluj zależności:\n   ```bash\n   npm install\n   ```\n3. Skonfiguruj zmienne środowiskowe w pliku `.env` (skorzystaj z `.env.example`)\n4. Uruchom aplikację w trybie deweloperskim:\n   ```bash\n   npm start\n   ```\n\n## 🟢 Dostępne skrypty\n\n- `npm start` - uruchamia aplikację w trybie deweloperskim\n- `npm test` - uruchamia testy\n- `npm run build` - buduje aplikację do produkcji\n\n## 🟢 Dokumentacja\n\nPełna dokumentacja projektu znajduje się w katalogu `docs/`:\n\n- [Instrukcja użytkownika](docs/user-guide/README.md)\n- [Dokumentacja dla deweloperów](docs/developer-guide/README.md)\n- [Dokumentacja API](docs/api/api.md)\n- [Schemat bazy danych](docs/database/README.md)\n\n## 🟢 Kredyty\n\n- Avatary użytkowników pochodzą z kolekcji [alohe/avatars](https://github.com/alohe/avatars) udostępnionej na licencji MIT. Kolekcja avatarów zawiera różnorodne darmowe obrazy profilowe, które można wykorzystać w projektach w celu dodania im osobowości i charakteru.\n- Ikony interfejsu pochodzą z biblioteki [React Icons](https://react-icons.github.io/react-icons/).\n- Elementy UI wykorzystują framework [Tailwind CSS](https://tailwindcss.com/).\n\n## 🟢 Licencja\n\nTen projekt jest objęty licencją MIT.\n\n--\n**Autor:** Marek161\n\n🟢 Future Plans\n\nW przyszłości dodatkowe funkcjonalności. Bardziej zaawansowane zarządzanie budżetem i walutami. Integracja z wiekszą ilością kalendarzy notion itd.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarek161%2Fapka-finansowa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarek161%2Fapka-finansowa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarek161%2Fapka-finansowa/lists"}