Skip to content

A Laravel API server responsible for handling user authentication, event creation, event registration, event management, and other features of the mobile app.

License

Notifications You must be signed in to change notification settings

itxSaaad/pugc-events-server-laravel

Repository files navigation

PUGC Events - Laravel API server for PUGC Events Mobile App

This project is a part of the Enterprise Application Development course at PUGC. The project is developed by the students of the BS Computer Science program at PUGC. The project is developed using the Laravel framework for the API server and the React-Native framework for the mobile app.


PUGC Events - Laravel API

A Laravel API server for the PUGC Events Mobile App

Explore the docs »

Report Bug . Request Feature

Contributors Forks Stargazers Issues MIT License

Table Of Contents

About The Project

PUGC Events is a Laravel API server for the PUGC Events Mobile App. The API server is built using the Laravel framework and provides endpoints for the mobile app to interact with the database. The API server is responsible for handling user authentication, event creation, event registration, event management, and other features of the mobile app.

Features

User Authentication

  • User Registration: User can register using their name, email and password.
  • User Login: User can login using their email and password.
  • User Logout: User can logout from the app.
  • User Profile: User can view their profile information.

Events

  • Event Creation: Admin can create an event with the following details:

    • Event Title
    • Event Description
    • Event Date
    • Event Time
    • Event Location
  • Event Update: Admin can update the event details.

  • Event Deletion: Admin can delete the event.

  • Event Details: User can view the event details.

  • Event List: User can view the list of all events.

RSVP

  • Event Registration: User can register for an event.
  • Event Unregistration: User can unregister from an event.

Built With

  • Laravel - The PHP Framework For Web Artisans
  • MySQL - The world's most popular open-source database

Getting Started

Prerequisites

  • PHP - PHP is a popular general-purpose scripting language that is especially suited to web development.
  • Composer - Composer is a dependency manager for PHP.
  • Node.js - Node.js is a JavaScript runtime built on Chrome's V8 JavaScript engine.
  • NPM - npm is the package manager for JavaScript.
  • MySQL - The world's most popular open-source database.
  • Git - Git is a free and open-source distributed version control system.

Installation

  1. Clone the repo

    git clone https://github.com/itxSaaad/pugc-events-server-laravel.git
  2. Install NPM packages

    npm install
  3. Install Composer packages

    composer install
  4. Create a new database in MySQL

  5. Copy the .env.example file to .env and update the database credentials

    cp .env.example .env
  6. Generate a new application key

    php artisan key:generate
  7. Run the database migrations

    php artisan migrate
  8. Start the Laravel server

    php artisan serve
  9. The Laravel server will start at http://localhost:8000

  10. You can now access the API server at http://localhost:8000/api

  11. For Hot Reload, you can run the following command

    npm run dev

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  • If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or directly create a pull request after you edit the README.md file with necessary changes.
  • Please make sure you check your spelling and grammar.
  • Create individual PR for each suggestion.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the repo
  2. Clone the project
  3. Create your feature branch (git checkout -b feature/AmazingFeature)
  4. Commit your changes (git commit -m "Add some AmazingFeature")
  5. Push to the branch (git push origin feature/AmazingFeature)
  6. Open a pull request

Authors

See also the list of contributors

License

Distributed under the MIT License. See LICENSE for more information.

Support

Give ⭐️ if you like this project!

About

A Laravel API server responsible for handling user authentication, event creation, event registration, event management, and other features of the mobile app.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published