Dirasati

Dirasati is a web application designed to help educators and students manage and enhance the learning experience through an intuitive platform integrating React, Laravel, and Inertia.js.

Getting Started

Docker (Windows)

After pulling the Git repository, ensure you have Docker installed. Then, navigate to the docker/dev directory and run the following command to build and start the containers:

cd docker/dev

docker compose up --build

Once the containers are running, access the application at:

• Backend (Laravel API & Web App): http://localhost:8000
• Vite Development Server: http://localhost:5173 (Not needed for direct access, as Inertia handles frontend updates)

Docker (Linux)

After pulling the Git repository, ensure you have Docker Compose installed. Then, navigate to docker/dev, make the entrypoint script executable, and build and start the containers:

chmod +x docker/dev/entrypoint.sh

cd docker/dev

docker compose up --build

Access the application at:

• Backend (Laravel API & Web App): http://localhost:8000
• Vite Development Server: http://localhost:5173 (Not needed for direct access, as Inertia handles frontend updates)

Deployment Steps

When moving to production(when you finish your code), follow the same steps as above but using the docker/deploy folder instead of docker/dev:

chmod +x docker/deploy/entrypoint.sh

cd docker/deploy

docker compose up --build

Working with Docker

Accessing the Container Shell

To enter the Laravel container shell, run:

docker exec -it dev-laravel-1 sh

Running PHP Artisan Commands

To execute a Laravel Artisan command inside the container, use:

docker exec -it laravel-app php artisan <command>

Running Node Commands

To run a Node.js command inside the container, use:

docker exec -it laravel-app node

Important Remarks

• You can access the container terminal via Docker Desktop using the Exec feature.
• The container environment behaves similarly to a standard local system.
• You only need to run docker compose up --build once; subsequent runs can be managed directly from Docker Desktop.
• Frontend Development: Changes in the frontend will reflect automatically in the browser, but some updates may take a few seconds to apply.

Troubleshooting & Support

If you encounter any issues, feel free to reach out for help!

---

Dirasati - Empowering Education through Technology