{"id":28911682,"url":"https://github.com/code-shams/kindlevent-client-a11-ph","last_synced_at":"2026-04-15T05:31:44.297Z","repository":{"id":299853651,"uuid":"1004406451","full_name":"code-shams/kindleVent-client-a11-ph","owner":"code-shams","description":"Kindlevent is a community-driven social service events platform. Featuring functionalities like event creation, management, joining etc. And modern glassmorphism inspired UI with dark/light mode toggle. This project is built with React and deployed on Firebase.","archived":false,"fork":false,"pushed_at":"2025-06-18T16:06:22.000Z","size":1049,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-18T17:24:33.318Z","etag":null,"topics":["date-fns","date-picker","firebase","javascript","lottie-animation","mern-stack","react-router","reactjs","tailwindcss","theme-change","vite"],"latest_commit_sha":null,"homepage":"https://kindlevent-sh.web.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/code-shams.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,"zenodo":null}},"created_at":"2025-06-18T15:17:05.000Z","updated_at":"2025-06-18T16:06:26.000Z","dependencies_parsed_at":"2025-06-18T17:24:51.989Z","dependency_job_id":"023ff355-22a3-42ae-aee4-c7d65268e943","html_url":"https://github.com/code-shams/kindleVent-client-a11-ph","commit_stats":null,"previous_names":["code-shams/kindlevent-client-a11-ph"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/code-shams/kindleVent-client-a11-ph","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-shams%2FkindleVent-client-a11-ph","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-shams%2FkindleVent-client-a11-ph/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-shams%2FkindleVent-client-a11-ph/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-shams%2FkindleVent-client-a11-ph/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/code-shams","download_url":"https://codeload.github.com/code-shams/kindleVent-client-a11-ph/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-shams%2FkindleVent-client-a11-ph/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261179155,"owners_count":23120861,"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","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":["date-fns","date-picker","firebase","javascript","lottie-animation","mern-stack","react-router","reactjs","tailwindcss","theme-change","vite"],"created_at":"2025-06-21T19:09:32.484Z","updated_at":"2026-04-15T05:31:44.278Z","avatar_url":"https://github.com/code-shams.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kindlevent Client\n\n**Live Demo:** [https://kindlevent-sh.web.app/](https://kindlevent-sh.web.app/)\n\n## 📌 Table of Contents\n\n1. [Project Overview](#project-overview)\n2. [Features](#features)\n3. [Tech Stack \u0026 Dependencies](#tech-stack--dependencies)\n4. [Installation \u0026 Setup](#installation--setup)\n5. [Environment Variables](#environment-variables)\n6. [Available Scripts](#available-scripts)\n7. [Folder Structure](#folder-structure)\n8. [Responsive Design](#responsive-design)\n9. [Deployment](#deployment)\n10. [Author](#author)\n\n---\n\n## 📝 Project Overview\n\n**Kindlevent** is a community-driven social service events platform. Users can:\n\n-   Discover and join upcoming local events (cleanups, tree plantations, donations, etc.)\n-   Create and manage their own events\n-   Toggle between light and dark themes\n-   Securely authenticate with email/password or Google\n\nThis client application is built with React and deployed on Firebase.\n\n---\n\n## 🚀 Features\n\n-   **Event Management**\n\n    -   Create events with future-date validation\n    -   View upcoming events in a responsive grid\n    -   Join events and track joined events\n    -   Manage (edit) events you created\n\n-   **Search \u0026 Filter**\n\n    -   Search events by title\n    -   Filter events by type (Cleanup, Plantation, Donation, etc.)\n\n-   **UI/UX Enhancements**\n\n    -   Theme toggle (light/dark mode)\n    -   Toast and SweetAlert2 notifications\n    -   Date picker with `react-datepicker`\n    -   Loader animations with `lottie-react`\n\n-   **Static Sections**\n\n    -   Banner \u0026 Features section\n    -   Gallery showcase\n    -   Newsletter subscription form (UI only)\n\n---\n\n## 🛠 Tech Stack \u0026 Dependencies\n\n-   **Framework:** React (via Vite)\n-   **Routing:** react-router@^7.6.2\n-   **State \u0026 API:** axios@^1.9.0\n-   **Styling:** Tailwind CSS@^4.1.8, daisyUI@^5.0.43\n-   **Date Handling:** date-fns@^4.1.0, react-datepicker@^8.4.0\n-   **Icons \u0026 Animations:** lucide-react@^0.514.0, react-icons@^5.5.0, lottie-react@^2.4.1, react-simple-typewriter@^5.0.1\n-   **Notifications:** react-toastify@^11.0.5, sweetalert2@^11.22.0\n-   **Firebase:** firebase@^11.9.0\n-   **Theme Control:** theme-change@^2.5.0\n\n\u003e For the full list, see `package.json` dependencies.\n\n---\n\n## 📥 Installation \u0026 Setup\n\n1. **Clone the repository**\n\n    ```bash\n    git clone https://github.com/\u003cyour-username\u003e/kindlevent-client.git\n    cd kindlevent-client\n    ```\n\n2. **Install dependencies**\n\n    ```bash\n    npm install\n    ```\n\n3. **Configure environment**\n\n    - Copy `.env.local.example` to `.env.local`\n    - Add your Firebase project credentials\n\n4. **Start development server**\n\n    ```bash\n    npm run dev\n    ```\n\n5. Open your browser and navigate to `http://localhost:5173`.\n\n---\n\n## 🔑 Environment Variables\n\nCreate a file named `.env.local` at the root of the project with the following variables:\n\n```\nVITE_API_BASE_URL=https://kindlevent-server.vercel.app\nVITE_FIREBASE_API_KEY=\u003cYOUR_FIREBASE_API_KEY\u003e\nVITE_FIREBASE_AUTH_DOMAIN=\u003cYOUR_FIREBASE_AUTH_DOMAIN\u003e\nVITE_FIREBASE_PROJECT_ID=\u003cYOUR_FIREBASE_PROJECT_ID\u003e\nVITE_FIREBASE_STORAGE_BUCKET=\u003cYOUR_FIREBASE_STORAGE_BUCKET\u003e\nVITE_FIREBASE_MESSAGING_SENDER_ID=\u003cYOUR_FIREBASE_MESSAGING_SENDER_ID\u003e\nVITE_FIREBASE_APP_ID=\u003cYOUR_FIREBASE_APP_ID\u003e\n```\n\n\u003e **Note:** Ensure `.env.local` is added to `.gitignore` to keep credentials secure.\n\n---\n\n## 📋 Available Scripts\n\n```bash\n# Start development server\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Preview production build\nnpm run preview\n```\n\n---\n\n## 📂 Folder Structure\n\n```\nkindlevent-client/\n├── public/                # Static assets\n├── src/\n│   ├── assets/            # Images, icons, Lottie files\n│   ├── components/        # Reusable UI components\n│   ├── contexts/          # Auth \u0026 theme context\n│   ├── pages/             # Route components\n│   ├── services/          # API call functions\n│   ├── styles/            # Global styles (Tailwind config)\n│   ├── utils/             # Helper functions\n│   ├── App.jsx            # App root\n│   └── main.jsx           # Entry point\n├── .env.local             # Environment variables (ignored)\n├── firebase.json          # Firebase hosting config\n├── vite.config.js         # Vite configuration\n└── README.md              # Project documentation\n```\n\n---\n\n## 📱 Responsive Design\n\nThis application is built mobile-first and has been tested on:\n\n-   **Mobile:** Any 320px+ width\n-   **Tablet:** 768px+ width\n-   **Desktop:** 1024px+ width\n\nAll components adapt fluidly across different viewports.\n\n---\n\n## 🚀 Deployment\n\nThis client is deployed to Firebase Hosting:\n\n```bash\n# To deploy\nnpm run build\nfirebase deploy\n```\n\n\u003e Ensure your Firebase project has `https://kindlevent-sh.web.app` authorized under Hosting settings.\n\n---\n\n## 👤 Author\n\n**Maksudur Rahman**\nGitHub: [github.com/code-shams](https://github.com/code-shams)\n\n_Happy coding!_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-shams%2Fkindlevent-client-a11-ph","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcode-shams%2Fkindlevent-client-a11-ph","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-shams%2Fkindlevent-client-a11-ph/lists"}