Track membership and roles within various groups, committees, taskforces, and departments at UMN.
Blue Sheeet uses Laravel's docker environment, Laravel Sail for development.
Prereqs:
To get started:
# Create a .env file
cp .env.example .env
# Install php dependencies
composer install
# Start Sail
sail up
# create app key, link storage, etc
sail exec app ./bin/ci.sh
# migrate the database
sail artisan migrate:fresh --seed
# Install node modules
yarn install
# Start Vite
yarn dev
The application will be running on http://localhost.
sail up
yarn dev
Load http://localhost in your browser.
Login with:
admin
admin
Additional users can be configured in config/shibboleth.php
.
Stop the application: sail down
.
Some features of BlueSheet require access to Bandaid API (e.g. the Faculty Leaves Planning Report page).
To connect to Bandaid for local development:
username
> Edit > Add Token..env
as BANDAID_KEY=<your token>
Enviroment Name | URL |
---|---|
dev |
https://cla-groups-dev.oit.umn.edu |
stage |
https://cla-groups-tst.oit.umn.edu |
prod |
https://cla-groups-prd.oit.umn.edu |
./vendor/bin/dep deploy <environment name>
BlueSheet documentation is in the docs
folder, and published at https://umn-latis.github.io/bluesheet/. It uses VitePress for static site generation.
To develop locally:
cd docs
yarn install
yarn docs:dev
Building the documentation:
cd docs
yarn docs:build
and publishing:
cd docs
yarn docs:publish