🧱 Bifrost - Base Repository

---

English

📌 Overview

Bifrost is a lightweight PHP framework template designed to accelerate web development, offering a simple structure and automation tools for common tasks.

📁 Project Structure

This repository includes a .vscode/tasks.json file that automates pulling dependencies (e.g., API, APP, Database, etc.) from other repositories.

✅ Requirements

• Git
• Docker
• Docker Compose
• Visual Studio Code (VS Code)

🚀 Getting Started

1. Clone the repository:

git clone https://github.com/Felipe-Cavalca/Bifrost.git
cd Bifrost

2. Open the project in VS Code:

code .

3. Run tasks to pull dependencies:

   • Go to Terminal > Run Task...
   • Choose one of the available tasks in tasks.json

4. Start Docker containers:

docker-compose up --build -d

🤝 Contributing

We welcome contributions! Follow these steps:

1. Fork this repo

2. Create a feature branch:

git checkout -b my-feature

3. Commit your changes:

git commit -m "feat: add new feature"

4. Push to origin:

git push origin my-feature

5. Open a Pull Request

---

Português

📌 Visão Geral

Bifrost é um template de framework PHP criado para acelerar o desenvolvimento web, oferecendo uma estrutura simples e automações para tarefas comuns.

📁 Estrutura do Projeto

Este repositório inclui o arquivo .vscode/tasks.json, que automatiza o processo de puxar dependências (como API, APP, Banco e outros).

✅ Requisitos

• Git
• Docker
• Docker Compose
• Visual Studio Code (VS Code)

🚀 Primeiros Passos

1. Clone o repositório:

git clone https://github.com/Felipe-Cavalca/Bifrost.git
cd Bifrost

2. Abra o projeto no VS Code:

code .

3. Execute as tarefas do tasks.json:

   • Vá em Terminal > Executar Tarefa...
   • Escolha uma das tarefas disponíveis

4. Inicie os containers Docker:

docker-compose up --build -d

🤝 Contribuindo

Contribuições são bem-vindas! Siga os passos:

1. Faça um fork deste repositório

2. Crie uma branch para sua feature:

git checkout -b minha-feature

3. Faça os commits:

git commit -m "feat: adiciona nova funcionalidade"

4. Envie para o repositório remoto:

git push origin minha-feature

5. Abra um Pull Request

---

🔧 Simple and structured. Ready to build.