Skip to content

Latest commit

 

History

History
87 lines (54 loc) · 4.4 KB

README.md

File metadata and controls

87 lines (54 loc) · 4.4 KB
Raw

LaraJobs Logo

LaraJobs Desktop

An open source NativePHP menu bar application for MacOS, providing instant notifications when new jobs are posted on LaraJobs.

Description

LaraJobs Desktop is a convenient way to stay updated with the latest job postings from LaraJobs. The application sits in your menu bar, providing non-intrusive notifications and a quick overview of new job opportunities, ensuring you never miss out on your dream job.

Features:

Notification with single new job

Notification with multiple new jobs

Notification with no new jobs

  • Get notified about new job postings
  • Send batched notifications, just one, or an explicit "No new jobs" depending on the number of new jobs identified.

Jobs list

  • View list of most recent job postings

MenuBar context menu item

  • Quick links to submit postings or search for Laravel Consultants

  • Global hotkey to open the app (default: CmdOrCtrl+Shift+J)

  • Ability to filter jobs

Filter Settings

Filter New

Filter Populated

Roadmap

We have big plans for LaraJobs Desktop! Here are some features we're considering for future releases:

  • Automate building releases on publishing new tags through Github actions
  • Watch jobs functionality to keep track of jobs.
  • Click on a notification to see quick job details, with an option to go to the site.
  • Save job application details for easy reviewing later and to reduce effort required when applying to new jobs.
  • Track application status and write notes.
  • Ability to explicitly hide jobs
  • Backup / restore of settings.
  • Show timezone difference to current location.

Prerequisites

The LaraJobs Desktop application currently only supports MacOS. You will also need PHP, Composer, Node, & Yarn installed on your system. Recommended to use Laravel Herd and then install yarn via Homebrew (brew install yarn).

Installation

  1. Download the project (git clone [email protected]:UserScape/larajobs-desktop.git larajobs-desktop
  2. Run cd larajobs-desktop && composer install && npm install && npm run build
  3. Run cp .env.example .env
  4. Run php artisan key:generate
  5. Run php artisan native:serve

Usage

Use LaraJobs Desktop to stay informed about new jobs.

Potential Issues

Notifications aren't displaying:

Please make sure that notifications are enabled for the app. When running php artisan native:serve notifications are sent from the "Electron" app.

Broken: Electron notifications 1

Working: Electron notifications 2

Contributing

Contributions are welcome! Please ensure your pull requests adhere to the following Laravel coding guidelines: https://spatie.be/guidelines/laravel-php

License

This project is licensed under the MIT license - see the LICENSE file for details.

Acknowledgments