Stream Events

Description

This web application shows a list of events in a stream and has the following features:

• A new user is able to register using GitHub OAuth
• The users on the platform can have followers, subscribers, donations, and merch sales
• The first 100 events are shown to the user on their dashboard with ability to load more by scrolling down
• The list of events can be marked read or unread with persistence in database
• The dashboard shows user analytics such as the "total revenue", "total followers gained" and "top 3 items by sales"

Demo

stream-events.mov

Technology Stack

• Laravel (Breeze, Sanctum, Socialite)
• Next.js
• MySQL
• PHP Unit (Testing)

Run Application Locally

1. See official Starter Kit documentation to set up local development environment
2. Clone this repository
3. Get GITHUB_CLIENT_ID GITHUB_CLIENT_SECRET and GITHUB_REDIRECT_URI and set these values in .env
4. Run npm install in the frontend directory and composer install in the backend directory
5. Install MySQL and run php artisan migrate:refresh --seed to create database tables and seed data
6. Run npm run dev in frontend directory and php artisan serve in backend directory
7. Run php artisan test in backend directory to run tests
8. Visit http://localhost:3000 to see the frontend; backend is available at http://localhost:8000