This app is used to handle the content on Linda Carsltad (Github). It is a fully custom CMS system using techniques like CRUD and MVC to handle objects and events. The main use of the web appcliation is to handle the yearly initatiation, by creating and handling the information published to Linda Carlstad.
Install Docker on your system and follow the docker steps below.
Follow the official Laravel documentation for a detailed walkthrough using any Unix system, like macOS or any distribution on Linux.
Follow this simple guide to run a Laravel (8.x) project on your macOS based computer.
Follow this simple guide to run a Laravel (8.x) project on your Windows based computer.
Fetch the project to your machine, either using the GUI or the command below.
git clone https://github.com/Linda-Carlstad/admin.lindacarlstad.se.git
Locate the project on your machine via the terminal and follow the steps below.
Initialize the projects environment file
cp .env.example .envCreate a database in MySQL on your computer. (Only .env part needed when using docker)
The name of the database is dependent of what you have named the datbase in the
.envfile. Default name ishomestead. Username and password should be changed to what you use on your local web servers database manager. See example below.
Edit the .env file with your database credidentials.
Here is an example:
DB_HOST=mariadb
DB_PORT=3306
DB_DATABASE=adminpanel
DB_USERNAME=user
DB_PASSWORD=my_secure_password
Start the docker instances and the website
docker compose up -dEnter a bash shell within the php docker image (exit to end the session)
docker exec -it linda_admin_frontend /bin/bashTo stop the docker instances, run the command below in a new terminal session:
docker compose stopInstall all composer dependencies:
composer install
Install all NPM dependencies:
npm install
Generate application key:
php artisan key:generate
Seed the database:
php artisan migrate:refresh --seed
Run this to generate CSS and JS files:
npm run dev
Run the local development server:
php artisan servePorts if docker is used:
- phpmyadmin: 8090
- MariaDB: $DB_PORT (default is 3306)
- laravel: 8000
(add pictures of app)
Can also be found here - Contributing to Linda Carlstad
- Screenshot the problem
- Open a new issue
- Give it a meaningful title
- Describe the issue clearly
- Upload the screenshot
- Add useful labels
- Submit issue
- See the issue list
- Assign yourself to an issue
- Open a new branch
- Create your beautiful code
- Create a pull request
Recommended apps to get going fast:
- Atom/Sublime/PHPStorm
- MAMP
- Sequal Pro
- Google Chrome/Mozilla FireFox
- Sketch (design tool)
Special thanks to Felix Wetell, and Linda Carlstad It-committee 2018/2019 for creating this custom CMS.