StaLuKoop-Web

A modern web application built using the VILT stack: Laravel + Inertia.js + Vue.js + Tailwind CSS. This repository is part of the StaLuKoop organization and serves as the frontend/backend monolith for our cooperative platform.

Tech Stack

• Laravel 12 – Backend framework
• Inertia.js – Server-driven SPA architecture
• Vue 3 – Frontend framework
• Tailwind CSS – Utility-first styling
• Vite – Build tool and dev server

Installation

Expand to view recommended tools

Applications / Services to Install

To quickly set up PHP and related dependencies on Windows, run the following PowerShell command:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows'))

Afterwards, make sure to install these:

• Laravel Herd – Laravel development environment
• MySQL – Relational database system
• phpMyAdmin – Web UI for managing MySQL databases
• Node.js – JavaScript runtime for building frontend assets
• HeidiSQL – Alternative SQL client for MySQL

Optional Tweaks

cd path/of/phpmyadmin
composer update --no-dev

Clone the repository

git clone https://github.com/StaLuKoop/stalukoop-web.git
cd stalukoop-web

Project Setup

composer install
npm install
cp .env.example .env
php artisan key:generate

Inside .env

APP_NAME=Stalukoop
APP_URL=http://stalukoop-web.test

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=stalukoop_db
DB_USERNAME=root
DB_PASSWORD=

# Update your .env file with your local database credentials (MySQL).

Run database migrations

php artisan migrate

Start development

composer run dev

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'Add some feature')
4. Push to the branch (git push origin feature/my-feature)
5. Open a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For questions, suggestions, or bugs, please reach out via GitHub Issues: https://github.com/StaLuKoop/stalukoop-web/issues