Skip to content

juls0730/passport

Repository files navigation

Passport

Passport is a simple, fast, and lightweight web dashboard/new tab replacement.

"I cant believe I've never broken it" - me

Getting Started

Screenshot 2024-11-11 at 00-20-06 Passport

Prerequisites

Usage

  1. Clone the repository
  2. Configure the .env file, an example is provided in the .env example file
    • The OPENWEATHER_API_KEY is required for the weather data to be displayed
    • The OPENWEATHER_LAT and OPENWEATHER_LON are required for the weather data to be displayed
    • The PASSPORT_ADMIN_USERNAME and PASSPORT_ADMIN_PASSWORD are required for the admin dashboard
    • The PASSPORT_SEARCH_PROVIDER is the search provider used for the search bar, %s is replaced with the search query
  3. Run zqdgr build to build the project
  4. Deploy passport to your web server
  5. profit

Adding links and categories

The admin dashboard can be accessed at /admin, you will be redirected to the login page if you are not logged in, use the credentials you configured in the .env file to login. Once logged in you can add links and categories.

License

This project is licensed under the BSL-1.0 License - see the LICENSE file for details