Kompass is still in early stages of development
Additionally Kompass requires you to use
- PHP 8.1 or newer
- Laravel 9.45 or newer
- Livewire 2.10 or newer
- Alpine.js 3.0 or newer
- Tailwindcss 3.0 or newer
Before creating your project, you should ensure that your local machine has PHP and Composer (opens in a new tab) installed. If you are developing on macOS, PHP and Composer can be installed via Homebrew (opens in a new tab). In addition, we recommend installing Node and NPM (opens in a new tab).
After you have installed PHP and Composer, you may create a new Laravel project via the Composer
composer create-project laravel/laravel kompass
Or, you may create new Laravel projects by globally installing the Laravel installer via Composer:
composer global require laravel/installer
laravel new kompass
During the installation we need to use a MySQL database. You will need to create a new database and save the credentials for the next step.
We need to specify our Environment variables for our application. You will see a file named
.env.example, you will need to duplicate that file and rename it to
Then, open up the
.env file and update your DB_DATABASE, DB_USERNAME, and DB_PASSWORD in the appropriate fields. You will also want to update the APP_URL to the URL of your application.
Next make sure to create a new database and add your database credentials to your .env file, you will also want to add your application URL in the APP_URL variable:
APP_URL=http://localhost DB_HOST=localhost DB_DATABASE=kompass DB_USERNAME=root DB_PASSWORD=
Kompass is super easy to install. After creating your new Laravel application you can include the Kompass:
composer require secondnetwork/kompass
php artisan kompass:install
🎉 And that's it! You will now be able to visit your URL and see your Kompass application up and running.
For security measures you may want to regenerate your application key, be sure to run the following command below to secure your site before going live.
php artisan key:generate
After installing Kompass you can login with the following default credentials:
- email: [email protected]
- password: password
After logging in you can feel free to change the admin email, username, and password by visiting the settings section in the user menu.