kzPlants is a project aiming to provide a tracking tool for cannabis cultivation, thus facilitating the management and monitoring of your plants.
This repository contains a web application for tracking cannabis plantations. The application allows users to keep track of their different cannabis crops by recording information such as variety name, planting date, growth characteristics, fertilizer doses used, etc. It allows managing a to-do list for each of your plants to know your progress and how much time is left.
- Plantation tracking: Record and track the different varieties of cannabis you grow.
- Dashboards: Organize your plants
- Data management: Store detailed information about each variety, including planting dates, growth rates, treatments, etc.
- History: Display complete history for each plant.
- Photos: Add photos to your plants to track their growth.
- Analysis: Get different analyses on your plantations, currently: Status and watering, more to come.
To install and use this project, follow these steps:
- Clone this repository to your local machine using the following command:
git clone https://github.com/kinouzero/kzPlants.git
- Navigate to the project directory:
cd kzPlants
- Install PHP dependencies using Composer:
composer install
- Install javascript dependencies using npm :
npm install ln -s ../node_modules public/npm
- Copy the
.env.example
file and rename it to.env
:cp .env.example .env
- Generate a Laravel application key:
php artisan key:generate
- Configure your database in the
.env
file. - Run migrations to create database tables:
php artisan migrate
- Start the development server:
php artisan serve
- Access the application in your browser at
http://localhost:8000
.
You can also run this project using Docker. Make sure you have Docker installed on your machine.
- Clone this repository to your local machine using the following command:
git clone https://github.com/kinouzero/kzPlants.git
- Navigate to the project directory:
cd kzPlants
- Create a
.env
file and configure your database as mentioned earlier. - Run the Docker Compose command to create and start the containers:
docker-compose up -d
- Access the application in your browser at
http://localhost
.
If you wish to contribute to this project, you can follow these steps:
- Fork this project and clone your fork locally.
- Create a new branch for your feature (
git checkout -b feature/your-feature-name
). - Make your changes and commit them (
git commit -am \'Add a new feature: FeatureName\'
). - Push your changes to GitHub (
git push origin feature/your-feature-name
). - Submit a pull request.
Please make sure to adhere to the code of conduct and contribution guidelines when participating.
This project is licensed under the MIT License.
For any questions or suggestions, you can contact us at the following address: [email protected].
Note: This project is still in development! We appreciate any contributions from the community to make it better!