Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀pinnaInvest - Laravel + Livewire + Alpine.js + TailwindCSS + MySQL (Dockerized)

Laravel PHP MySQL Docker License Status

A modern app that showcases real world features of an financial service provider that offers passive investment to their clients built with Livewire, Alpine.js, and TailwindCSS — fully containerized using Docker for seamless local and production deployment. This project ships with admin dashboard and user dashboards through a multi-auth system. Caching is utilized and database querires are optimized to improve site performance.

🧠 Designed to demonstrate a clean, professional Laravel setup ready for production or portfolio showcase.


🧩 Features

✅ Laravel 11 + PHP 8.3 (FPM)
✅ Livewire 3 + Alpine.js for dynamic interactivity
✅ TailwindCSS via Vite build system
✅ MySQL 8 database container
✅ Nginx web server configuration for Laravel
✅ Auto-run migrations on container start
✅ One-command setup using Docker Compose


⚙️ Quick Start

1️⃣ Clone the repository

git clone https://github.com/yourusername/your-repo-name.git cd your-repo-name


2️⃣ Configure environment

Copy the example environment file and generate a key: cp .env.example .env php artisan key:


3️⃣ Build and run with Docker

docker compose up -d --build

Your app will now be available at: 👉 http://localhost:8000


🧠 Common Commands

Command Description
docker compose up -d --build Build and start all containers
docker compose down Stop all containers
docker compose down -v Stop and remove volumes (fresh start)
docker exec -it laravel_app bash Access the app container shell
php artisan migrate Run migrations manually inside container

🗄️ Database Access

Host: 127.0.0.1 Port: 3307 Database: laravel Username: laravel Password: secret

These credentials match your .env.example and docker-compose.yaml.


🧰 Tech Stack

Layer Technology
Framework Laravel 11
Frontend Livewire + Alpine.js + TailwindCSS
Server PHP 8.3 (FPM) + Nginx
Database MySQL 8
Build Tool Vite
Containerization Docker & Docker Compose

🐳 Docker Architecture

├── app → PHP-FPM container (Laravel) ├── web → Nginx container (serves /public) └── db → MySQL container (persistent volume) Each container communicates through an internal Docker network (laravel_net).


🧱 Project Structure

├── app/ ├── bootstrap/ ├── config/ ├── docker/ │ └── nginx/ │ └── default.conf ├── public/ ├── resources/ ├── routes/ ├── storage/ ├── .env.example ├── Dockerfile ├── docker-compose.yaml └── README.md


🔐 Environment Setup Notes

  • Your real .env file should not be committed — only .env.example is tracked.
  • The default credentials are for demo purposes only.
  • You can override environment variables in docker-compose.yaml or through your host’s environment.

🧪 Development Notes

  • To rebuild TailwindCSS/Alpine/Vite assets locally:

npm install npm run dev

  • For production builds inside Docker: npm run build

🤝 Contributing

Pull requests are welcome! If you’d like to make improvements or fix bugs, please:

  • Fork the repo
  • Create a new branch
  • Submit a PR describing your changes

📄 License

This project is open-sourced under the [LICENSE](MIT License).


❤️ Built by [https::/github.com/Chukwusombiri](Bounty Tech)

“Code as if the next person to maintain it is a future version of you.”

About

Financial assets management platform learning project

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages