Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Aug 9, 2025

This PR adds a comprehensive .github/copilot-instructions.md file that provides GitHub Copilot with detailed, validated instructions for working effectively with the Glowing Telegram Frontend codebase.

What's Included

The instructions file contains thoroughly tested and validated information covering:

Essential Setup & Commands

  • Complete dependency installation process (npm install - 60-90 seconds)
  • Environment configuration setup (cp .env.defaults .env)
  • All build and test commands with measured execution times
  • Critical timeout requirements and "NEVER CANCEL" warnings for long operations

Development Workflow

  • Development server setup (npm run start on localhost:5173)
  • Storybook component documentation (npm run storybook on localhost:6006)
  • Code quality tools (Biome for linting/formatting, TypeScript checking)
  • Production build process with expected timing (15-20 seconds)

Manual Validation Requirements

  • Specific user scenarios that must be tested after changes
  • Navigation flows between Series, Streams, Episodes, and other React Admin pages
  • Stream Manager interface testing
  • Filter persistence validation procedures

Expected Issues & Workarounds

  • Authentication errors in development (normal with placeholder Cognito credentials)
  • Build warnings about chunk sizes and any types (expected and documented)
  • MSW mock integration for API development

Repository Structure

  • Detailed breakdown of /src organization (components, resources, utilities)
  • Key configuration files and their purposes
  • CI/CD pipeline information for GitHub Actions

Validation Process

Every command and instruction was exhaustively tested:

  • ✅ All commands executed successfully with measured timings
  • ✅ Development server tested with full application navigation
  • ✅ Storybook functionality verified with component interactions
  • ✅ Build and test processes validated end-to-end
  • ✅ Manual user scenarios tested with screenshots captured

Additional Improvements

  • Added storybook-static to .gitignore to prevent build artifacts in version control
  • Cleaned up accidentally committed Storybook build files

The instructions follow an imperative tone as requested and provide GitHub Copilot with everything needed to work effectively in this React 19 + TypeScript + Vite frontend codebase without requiring additional context gathering.

Fixes #95.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

  • storybook.js.org
    • Triggering command: node /home/REDACTED/work/glowing-telegram-frontend/glowing-telegram-frontend/node_modules/.bin/storybook dev -p 6006 (dns block)
    • Triggering command: node /home/REDACTED/work/glowing-telegram-frontend/glowing-telegram-frontend/node_modules/.bin/storybook build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Copilot AI and others added 2 commits August 9, 2025 16:04
Co-authored-by: saebyn <185030+saebyn@users.noreply.github.com>
Co-authored-by: saebyn <185030+saebyn@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] ✨Set up Copilot instructions Add comprehensive GitHub Copilot instructions for React frontend development Aug 9, 2025
@Copilot Copilot AI requested a review from saebyn August 9, 2025 16:06
Copilot finished work on behalf of saebyn August 9, 2025 16:06
@saebyn saebyn requested a review from Copilot August 9, 2025 16:08
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds comprehensive GitHub Copilot instructions to improve AI assistance when working with the Glowing Telegram Frontend React codebase. The instructions provide detailed setup commands, development workflows, validation requirements, and troubleshooting guidance to help Copilot work more effectively without requiring additional context gathering.

  • Adds detailed setup and development commands with execution times and timeout requirements
  • Documents manual validation procedures and required user scenarios for testing changes
  • Provides repository structure overview and common development tasks guidance

Reviewed Changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 1 comment.

File Description
.github/copilot-instructions.md Comprehensive new instructions file covering setup, development workflow, testing, and repository structure
public/mockServiceWorker.js Updates MSW package version from 2.7.3 to 2.8.4

@saebyn saebyn marked this pull request as ready for review August 9, 2025 16:09
@saebyn saebyn enabled auto-merge (rebase) August 9, 2025 16:09
@saebyn saebyn merged commit 2621ca3 into main Aug 9, 2025
4 checks passed
@saebyn saebyn deleted the copilot/fix-95 branch August 9, 2025 16:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

✨Set up Copilot instructions

2 participants