Add GitHub Copilot workspace configuration file for project setup

[Copilot]

Overview

This PR adds a comprehensive .github/copilot.yml file that provides GitHub Copilot with detailed information about the BLT project structure and setup process. This configuration enables better context-aware assistance during development and serves as a machine-readable reference for automated setup workflows.

What's Added

The new .github/copilot.yml file includes:

Project Information

• Project name, description, type, language, and framework details
• Identifies BLT as a Django 5.1+ web application built with Python 3.11+

Complete Setup Documentation

Structured information for all three supported setup methods:

1. Docker Setup (Recommended)

   • Prerequisites and dependencies
   • Step-by-step commands for building and running containers
   • Notes about LF line endings, port configuration, and HTTPS redirect issues

2. Poetry/Virtual Environment Setup

   • Python version requirements
   • Poetry commands for dependency management
   • Database migration and static file collection steps

3. Vagrant/VM Setup

   • VM provisioning steps
   • Project configuration within the VM environment

Development Workflow

• Common development commands for each setup method
• Code style guidelines integrated from .github/copilot-instructions.md
• Key project files with descriptions
• Testing framework information

Troubleshooting Guide

• Common setup issues and their solutions
• Support resources and documentation links
• Environment variable configuration details

Benefits

This configuration file helps:

• GitHub Copilot understand the project structure and provide more accurate code suggestions
• New contributors get started quickly with clear setup instructions in a standardized format
• Automated tools parse project setup requirements programmatically
• CI/CD workflows reference consistent setup procedures

Validation

• ✅ YAML syntax validated
• ✅ All setup methods documented from docs/Setup.md
• ✅ Code style guidelines from .github/copilot-instructions.md included
• ✅ Common troubleshooting scenarios covered

Closes the issue requesting a copilot file for project setup.

Original prompt

Setup a copilot file that sets up the project

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

Note

Free review on us!

CodeRabbit is offering free reviews until Wed Oct 08 2025 to showcase some of the refinements we've made.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}