{"id":26194510,"url":"https://github.com/pitzzahh/evently","last_synced_at":"2025-06-14T09:37:56.148Z","repository":{"id":279169365,"uuid":"934589954","full_name":"pitzzahh/evently","owner":"pitzzahh","description":"An event attendance management system that helps organize events and track participant attendance. It offers QR code scanning, attendance tracking, and reporting features.","archived":false,"fork":false,"pushed_at":"2025-05-26T03:06:34.000Z","size":13655,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-26T04:28:34.943Z","etag":null,"topics":["attendance-management-system","event-management","qr-code","svelte-tauri","sveltekit","tauri-app","web-workers"],"latest_commit_sha":null,"homepage":"","language":"Svelte","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pitzzahh.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","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-02-18T04:46:06.000Z","updated_at":"2025-05-26T03:06:39.000Z","dependencies_parsed_at":"2025-02-24T07:24:02.659Z","dependency_job_id":"fd468075-855c-4168-8952-a76a09422d71","html_url":"https://github.com/pitzzahh/evently","commit_stats":null,"previous_names":["pitzzahh/evently"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/pitzzahh/evently","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitzzahh%2Fevently","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitzzahh%2Fevently/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitzzahh%2Fevently/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitzzahh%2Fevently/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pitzzahh","download_url":"https://codeload.github.com/pitzzahh/evently/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pitzzahh%2Fevently/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259796304,"owners_count":22912688,"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":["attendance-management-system","event-management","qr-code","svelte-tauri","sveltekit","tauri-app","web-workers"],"created_at":"2025-03-12T01:57:16.033Z","updated_at":"2025-06-14T09:37:56.136Z","avatar_url":"https://github.com/pitzzahh.png","language":"Svelte","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/pitzzahh/evently/refs/heads/main/static/favicon.png\" alt=\"Evently Logo\" width=\"200\"/\u003e\n  \u003c!-- \u003cp style=\"font-size: 2em; font-weight: bold; margin: 0.5em;\"\u003eEvently\u003c/p\u003e --\u003e\n  \u003ch1\u003eEvently\u003c/h1\u003e\n  \u003ca href=\"https://github.com/pitzzahh/evently/actions/workflows/publish.yml\"\u003e\n    \u003cimg src=\"https://github.com/pitzzahh/evently/actions/workflows/publish.yml/badge.svg\" alt=\"publish\" /\u003e\n  \u003c/a\u003e\n\n  \u003cp\u003e\n    \u003cstrong\u003eEvently\u003c/strong\u003e is an event attendance management system that helps organize events and track participant attendance. It offers QR code scanning, attendance tracking, and reporting features to assist event organizers with their workflow.\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## Download\n\nCheck the [latest release](https://github.com/pitzzahh/evently/releases/latest) for the most up-to-date version.\n\nAvailable for:\n\n- Windows\n- macOS\n- Linux\n\n## Features\n\n### Event Management\n\n- Create and manage single or multi-day events\n- Set AM/PM time slots with specific start and end times\n- Calendar view with Month, Week, Day, and Agenda perspectives\n- Event status tracking (upcoming, ongoing, or completed)\n\n### Participant Management\n\n- Add individual participants to events\n- Bulk import participants from Excel files\n- Generate unique QR codes for each participant\n- Send QR codes directly to participants via email\n\n### Attendance Tracking\n\n- Scan participant QR codes using hardware scanners or device camera\n- Track AM and PM check-in/check-out times\n- Real-time attendance status updates\n\n### Reporting\n\n- Export daily attendance reports to PDF\n- Generate participant QR code sheets in PDF format\n- Export full event attendance records to Excel or PDF\n\n### Additional Features\n\n- Automatic update notifications with in-app update functionality\n- Offline-first architecture for reliable operation\n\n## Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/pitzzahh/evently.git\n\n# Navigate to the project directory\ncd evently\n\n# Install dependencies\nbun install\n# or\nyarn install\n# or\nnpm install\n```\n\n## Usage\n\nStart the development server:\n\n```bash\nbun tauri dev\n#or\npnpm run tauri dev\n# or\nnpm run tauri dev\n```\n\nFor production builds:\n\n```bash\nbun run tauri build\n```\n\nThis will create a production build of the application in the `src-tauri/target/release` directory.\n\n## Environment Variables Setup\n\nTo run this project locally, you need to set up environment variables:\n\n1. Copy the `.env.example` file to a new file named `.env`:\n\n   ```bash\n   cp .env.example .env\n   ```\n\n2. Fill in the values in your new `.env` file:\n\n   ### Email Service (Plunk)\n\n   - `PLUNK_API`: Your Plunk API endpoint\n   - `PLUNK_SK`: Your Plunk secret key from your dashboard\n\n   ### Cloud Storage (Cloudinary)\n\n   - `CLOUDINARY_API_URL`: Cloudinary API URL (typically https://api.cloudinary.com/v1_1)\n   - `CLOUD_NAME`: Your Cloudinary cloud name\n   - `UPLOAD_PRESET`: Your Cloudinary upload preset name\n\n3. Once all environment variables are set, you can start the development server.\n\n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003cdiv style=\"display: grid; grid-template-columns: repeat(auto-fit, minmax(400px, 1fr)); gap: 20px; justify-items: center; max-width: 1200px; margin: 0 auto;\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/pitzzahh/evently/refs/heads/main/upcoming-events.png\" alt=\"Upcoming events list\" width=\"100%\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/pitzzahh/evently/refs/heads/main/past-events.png\" alt=\"Past events list\" width=\"100%\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/pitzzahh/evently/refs/heads/main/event-details.png\" alt=\"Event details\" width=\"100%\"/\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/pitzzahh/evently/refs/heads/main/event-participants.png\" alt=\"Event participants\" width=\"100%\"/\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\n## Development\n\nEvently is mainly built with:\n\n- [SvelteKit](https://github.com/sveltejs/kit) for the frontend\n- [shadcn-svelte](https://github.com/huntabyte/shadcn-svelte) for UI components\n- [Tauri](https://tauri.app/) for the cross-platform desktop application\n- [TailwindCSS](https://github.com/tailwindlabs/tailwindcss) for styling\n- [SignalDB](https://github.com/maxnowack/signaldb) for real-time data synchronization using OPFS\n- [pdfmake](https://github.com/bpampuch/pdfmake) for PDF generation\n- [event-calendar](https://originui.com/event-calendar) for the calendar component\n- [exceljs](https://github.com/exceljs/exceljs) for Excel file handling\n- [svelte-put/qr](https://svelte-put.vnphanquang.com/docs/qr) for QR code generation\n- [react](https://github.com/facebook/react) for rendering the calendar component\n- and many more.\n\n## Building for Desktop\n\nEvently uses Tauri to create desktop applications:\n\n```bash\nnpm run tauri build\n```\n\nThis will produce executable files for your operating system in the `src-tauri/target/release` directory.\n\n## License\n\nApache License 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpitzzahh%2Fevently","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpitzzahh%2Fevently","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpitzzahh%2Fevently/lists"}