Skip to content
/ pandora Public template

🥢REST API starter kit powered by Laravel, OpenAPI, Sanctum.

License

Notifications You must be signed in to change notification settings

arifszn/pandora

Repository files navigation


Pandora

📦 REST API starter kit powered by Laravel, OpenAPI, Sanctum.

View Docs · Report Bug · Request Feature

Preview
Shadow

Pandora is a modern, customized, feature-rich API starter kit to kickstart your next REST API backend.

Features

Functionalities

Documentation

Complete documentation for Pandora can be found here.

Documentation

The API documentation:

Installation

Prerequisite

  • PHP 8.2

To setup Pandora, first clone the project and change the directory.

git clone https://github.com/arifszn/pandora.git
cd pandora

Then follow the process using either Docker or Without Docker and you will have a fully running Laravel installation with Sanctum, all configured.

With Docker (Sail)

Laravel Sail is a light-weight command-line interface for interacting with Laravel's default Docker development environment.

  1. Copy .env.example to .env:

    cp .env.example .env
  2. Install the dependencies:

    docker run --rm \
        -u "$(id -u):$(id -g)" \
        -v $(pwd):/var/www/html \
        -w /var/www/html \
        laravelsail/php82-composer:latest \
        composer install --ignore-platform-reqs
  3. Run the containers:

    ./vendor/bin/sail up -d
  4. Generate application key:

    ./vendor/bin/sail artisan key:generate
  5. Run database migration with seeder:

    ./vendor/bin/sail artisan migrate --seed

To learn more about Sail, visit the official Doc.

Without Docker

  1. Copy .env.example to .env:

    cp .env.example .env
  2. Install the dependencies:

    composer install
  3. Generate application key:

    php artisan key:generate
  4. Run database migration with seeder:

    php artisan migrate --seed
  5. Start the local server:

    php artisan serve

Support

You can show your support by starring this project.

Github Star

Contribute

To contribute, see the contributing guide.

Credits

This starter kit is inspired by the project Hydra.

License

MIT License