https://github.com/tighten/novapackages

https://github.com/tighten/novapackages

hacktoberfest laravel laravel-nova laravelnova

Last synced: 3 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/tighten/novapackages
• Owner: tighten
• Created: 2020-01-27T14:20:06.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2024-08-25T13:48:48.000Z (3 months ago)
• Last Synced: 2024-09-03T07:01:59.339Z (2 months ago)
• Topics: hacktoberfest, laravel, laravel-nova, laravelnova
• Language: PHP
• Homepage: https://novapackages.com
• Size: 9.82 MB
• Stars: 335
• Watchers: 14
• Forks: 61
• Open Issues: 21
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

• awesome-livewire - Nova Packages

README

        
![Nova Packages- Discover new packages. Build amazing things.](novapackages-banner.png?version=1)

# Nova Packages

## Setting up Passport

1. `php artisan passport:keys`

2. `php artisan passport:client --personal`

## Setting up Scout with Typesense

1. Set up a Typesense instance locally or on a server. For local development, you can use https://github.com/tighten/takeout to run Typesense.

2. Update the `.env` variables for your Typesense instance.

3. After seeding your database, run `php artisan scout:import "App\Package"`

## Seeding the Database

1. `php artisan db:seed`

## Setting up GitHub Authentication

1. Make a new [GitHub OAuth application](https://github.com/settings/developers)

2. Set `http://novapackages.test/login/github/callback` as the Authorized Callback URL

3. Copy the GitHub app id and secret to `GITHUB_CLIENT_ID` and `GITHUB_CLIENT_SECRET` in the `.env` file

4. Create a new [Personal Access Token](https://github.com/settings/tokens) with the `public_repo` scope enabled

5. Copy the token to `GITHUB_TOKEN` in the `.env` file.

## Setting up Slack Test Webhook

1. Add the `SLACK_URL` variable to your `.env` to post to a Slack channel of your choosing.

**Note:** This webhook is hit when certain events are fired. If you are not testing this webhook specifically, you may want to consider commenting it out to avoid sending unnecessary Slack notifications.

## Setting up the Filesystem for Screenshots

1. Run `php artisan storage:link`

## Testing

Some of the tests in this suite depend on an active internet connection, and will run by default. `tests/Feature/RepoTest.php` provides coverage for the ReadMe import feature, and `tests/Feature/CheckPackageUrlsCommandTest.php` provides coverage for the command that periodically validates package urls.

For convenience, these tests have been added to the `integration` group. If you would like to exlude these tests from running, you may do so by using phpunit's `--exclude-group` option:

```

phpunit --exclude-group=integration

```