AmarEvents — Archived Snapshot (~Beta 2.1.x, Nov–Dec 2025)

[

](LICENSE) [

](#) [

](#) [

](https://www.alwaysdata.com) [

](https://amarevents.zone.id) [

](#tech-stack)

AmarEvents is an event management and ticketing platform for organizers in Bangladesh — event creation, registration, ticketing, and organizer tools, with manual bKash/Nagad/Rocket wallet payments.

⚠️ This repository is an archived historical snapshot, published for reference. It is not the current production codebase — the live platform has since moved on to Production 1.0 and includes features (certificates, an ambassador program, staff/role permissions, a drag-and-drop ticket designer, an AI event builder, and more) that don't exist in this snapshot. See the comparison below.

🌐 Live product: amarevents.zone.id

Contents

• Version & Feature Comparison
• Features in This Snapshot
• What's Changed Since
• Screenshots
• Tech Stack
• Project Structure
• Setup
• Security Notes
• License
• Contact

---

Version & feature comparison

Which version is this?

Nothing in the code carries an explicit version string, so the estimate below comes from file timestamps and the feature set actually present, cross-checked against the maintainer's own changelog:

Signal	What we found	Points to
Archive timestamp (all files)	2025-12-14	A commit around that date
mysql.sql phpMyAdmin export date	2025-11-06	Schema frozen early Nov 2025
Session cookie lifetime	30 days	Before the "90-day login token" upgrade (Beta 2.2–2.9, Dec 29 2025)
Balance/earnings fields (users.money, organization.totalearn)	Present	After Beta 2.1.2 (Oct 29 2025) added the balance system
Legacy "Bangladeshi proxy" code	Absent	After Beta 2.1.2 removed it
Multi-language support	Absent	Before Beta 2.2–2.9 (Dec 29 2025)
Certificates / Ambassador / Staff+RBAC / Widgets / Ticket designer / Scanner / AI builder	All absent	Before Beta 3.1 at the earliest — most didn't ship until Beta 3.6/3.6.1/P1.0 (Jun 2026)

Best match: Beta 2.1.3 → early Beta 2.2 window (roughly Nov 6 – Dec 14, 2025).

One inconsistency worth flagging honestly: the maintainer's changelog lists AmarAi as shipping in Beta 2.1.1 (Oct 5, 2025), but no AmarAi code exists anywhere in this export, under that name or any other. Either it went straight to production without a matching commit on this branch, or it was pulled back out before this commit. Treat the version estimate as "best fit from the evidence," not a certainty.

Feature comparison: this snapshot vs. latest (P 1.0)

Feature	This Version	Latest (P1.0)	Description
Login	✅	✅	Sign in with email/password, Google, or Discord
Event Creation	✅	✅	Organizers create and manage events with custom registration fields
Ticketing	✅	✅	Free and paid registration with ticket status tracking
Payments	✅ Manual	✅ Automated	Collect bKash / Nagad / Rocket payments
SMS	✅ Basic	✅ Full	Send SMS updates to participants
Push Notifications	✅ Stub	✅ Full	Alert organizers when a new payment comes in
Admin Panel	✅ Basic	✅ Advanced	Manage users, donations, and platform settings
Themes	✅ 1 theme	✅ 3 themes	Dark, white, and orange modes
Languages	✅ English	✅ Multi-language	Interface language support
Certificates	❌	✅	Auto-generate certificates with QR + hash verification
Ambassador Program	❌	✅	Referral/ambassador system for organizers
Staff & Permissions	❌	✅	Multiple staff accounts with role-based access + audit logs
Widgets	❌	✅	Embed the registration form on an external website
Ticket Designer	❌	✅	Drag-and-drop custom ticket design tool
Public API	❌	✅	API access for developers, with docs
Maintenance Mode	❌	✅	Take the platform offline for updates
AI Assistant	❌	✅	AI-assisted event creation (AmarAi)
Scanner App	❌	✅	Dedicated app for scanning tickets at check-in

(Simplified to feature level — the maintainer's own changelog is the full line-by-line record.)

---

Features in this snapshot

• Auth: email/password, Google Sign-In, Discord OAuth2 (auto-joins a configured Discord guild via bot), BD-format (11-digit) phone capture on first login
• Events: create/edit, categories, deadline enforcement, prize info, location + map link, description, socials, custom fields (text/dropdown/checkbox/radio)
• Ticketing: free participation flow and paid registration flow, per-ticket custom field values, status tracking (Success/Pending/Failed/Expired)
• Payments: organizer-configured bKash/Nagad/Rocket wallet numbers, donation submissions with manual admin verification, OneSignal push-notification hook on new payment (credentials not wired in this export)
• Organizer tools: event gallery (ImageKit-hosted, up to 6 images/event), notices/announcements, per-event SMS toggle with templated messages ({name}/{event}/{location}/{date}/{prize}), participant export to Word via PHPWord (a PDF option exists in the UI but is disabled)
• Admin panel: login, user management, donation verification queue
• Comms: PHPMailer-based verification emails, organizer email composer
• Other: PWA install banner + offline fallback page, sitemap/robots.txt/SEO meta, rules/ToS page, help page

What's changed since

Condensed from the maintainer's changelog, in order:

• Beta 2.2–2.9 (Dec 2025): scanner + ticket saver, formal notification system, event builder, event page templates, DMCA/copyright pages, dedicated payment app, skeleton loading, mass email sender, maintenance system, multi-language, 90-day login tokens, richer custom fields
• Beta 3.0 (Feb 2026): 90-day+ logging, admin panel 2.0, GitHub sync, bulk-email fix, anti-email-failure system
• Beta 3.1 (Feb 2026): navbar overhaul, 3-theme support
• Beta 3.2 (Mar 2026): SMS-based ticket verification, dedicated organizer app, free plans, custom QR server, AmarWriter
• Beta 3.4 (Mar 2026): maintenance system, offline games
• Beta 3.5 (Apr 2026): 3 UI modes, 7-format export, Plans structure, DB editor, org widgets, public API
• Beta 3.6 / 3.6.1 (Jun 2026): custom ticket designer + widget builder, AmarAi event builder, staff system + full RBAC + audit logs, certificate system w/ hash + QR verification
• P 1.0 (Jun 30, 2026): ambassador system, permission-system fixes — production release, currently in a maintenance window

---

Screenshots

Page	Preview
Homepage	add link here
Event Page	add link here
Registration	add link here
Organizer Dashboard	add link here
Admin Panel	add link here

---

Tech stack

• Footprint: ~16MB total, dependencies included — no framework, no build step, no Docker. Runs on basic shared hosting (this project runs on AlwaysData)
• Backend: PHP, no framework — plain scripts + includes
• Database: MySQL/MariaDB (10.11)
• Frontend: vanilla JS, Tailwind CSS (via CDN), Lucide icons
• Libraries: PHPMailer, Dompdf, PHPWord (via Composer)
• Third-party services: Google Identity Services, Discord OAuth2, ImageKit (media hosting), OneSignal (push), RapidSMS (SMS gateway)
• Hosting: AlwaysData

Project structure

/                 Web root — top-level pages (index, login, register, event, etc.)
/config/          DB, mail, navbar, meta, and OAuth config (blocked from direct HTTP access via .htaccess)
/assests/         Front-end assets — icons, manifest, navbar.css (folder name as shipped)
/dashboard/       End-user account + ticket views
/organizer/       Organizer-facing tools (events, gallery, payments, sms, export, etc.)
/admin/           Admin panel
/vendor/          Composer dependencies

Setup

1. Clone and install dependencies:

   git clone https://github.com/harunabdullahrakin/Amar-Events.git
   cd Amar-Events
   composer install

2. Create a database and import the schema:

   mysql -u youruser -p yourdatabase < mysql.sql

3. Fill in your own credentials — every one of these ships blank/placeholder in this export:
   • config/db.php and admin/inc/db.php — DB host/name/user/pass
   • config/smtp.php and config/mailer.php — SMTP host/username/password
   • config/google.php — Google Identity client_id
   • discord.php — Discord client_id, client_secret, bot_token, guild_id
   • organizer/gallery.php, notice.php, events.php, edit.php — ImageKit private key
   • participate.php — RapidSMS user/pass + Discord webhook URLs (optional)
   • register.php — OneSignal app_id/API key (optional)
4. Serve locally:

   php -S localhost:8000

Security notes

Every credential (DB, SMTP, Google, Discord, ImageKit, RapidSMS, OneSignal) is a placeholder in this codebase — fill in your own before deploying, and never commit the real values.

If this code has ever run with real credentials filled in anywhere outside your own server, treat those credentials as compromised and rotate them.

.gitignore already excludes the files that would hold real credentials:

/vendor/
config/db.php
admin/inc/db.php
*.log
.DS_Store

Track placeholder versions of the config files in git; keep your real, filled-in copies out of it.

License

Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) — see LICENSE and CREDITS.md.

Contact

Harun Abdullah Rakin GitHub → @harunabdullahrakin Website → amarevents.zone.id

---

PHP MySQL Tailwind CSS Event Management Ticket Booking AlwaysData Archived Snapshot