Skip to content

danjohnson95/larajobs-desktop

 
 

Repository files navigation

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:

  • 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.
  • 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]:LukeTowers/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

Future Plans:

  • Fix publishing / building - currently the builds produced by native:build or native:publish don't actually register the MenuBar for some reason.
  • Automate building releases on publishing new tags through Github actions
  • Add support for preferences (i.e. filtering, refresh frequency, etc)
  • Ability to explicitly hide jobs

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

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 87.7%
  • Blade 11.8%
  • Other 0.5%