Reporting Bugs

Bug Reporting Overview

Help us improve Cypht by reporting bugs and issues you encounter. Your feedback is essential for maintaining the quality and reliability of this Open Source email client.

Cypht is an entirely volunteer effort, and we rely on community contributions to identify and fix issues. Every bug report helps make Cypht better for everyone.

Before Reporting

Follow these steps to ensure your bug report is effective and helps us resolve the issue quickly.

Check Existing Issues

Before creating a new report, search the GitHub issues to see if the bug has already been reported.

Reproduce the Issue

Try to reproduce the bug consistently. Note the exact steps that trigger the problem and any patterns you observe.

Gather System Information

Collect relevant details about your environment that might help diagnose the problem.

Helpful Information

  • Cypht version
  • PHP version
  • Web server (Apache/Nginx)
  • Browser and version
  • Operating system
  • Email provider(s) affected

When to Report

Report issues that are reproducible and affect functionality. Minor UI improvements or feature requests should use the contribution guidelines instead.

Security Issues

We take security seriously. If you discover a security vulnerability, please report it responsibly.

How to Report Security Issues

  1. Visit the Cypht Security page
  2. Follow the private reporting instructions
  3. Provide detailed information about the vulnerability
  4. Include steps to reproduce if possible

Reporting Channels

Choose the appropriate channel based on your issue type and urgency.

Bug Report Template

Use this template to ensure your bug report includes all necessary information for effective troubleshooting.

Issue Description

Provide a clear and concise description of the problem :

**Bug Description**

A clear and brief description of what the bug is.

**Expected Behavior**
What you expected to happen.

**Actual Behavior**
What actually happened instead.

Steps to Reproduce

**To Reproduce**

1.  Go to '...'
2.  Click on '....'
3.  Scroll down to '....'
4.  See error

Environment Information

**Environment**

- Cypht version: [e.g., 1.3.0]
- PHP version: [e.g., 8.1.0]
- Web server: [e.g., Apache 2.4.41]
- Database: [e.g., MySQL 8.0]
- Browser: [e.g., Chrome 91.0]
- OS: [e.g., Ubuntu 20.04]

Additional Context

Include any additional information that might help :

  • Screenshots or screen recordings
  • Error messages from logs
  • Browser console errors
  • Network requests that failed
  • Recent changes to your setup

Feature Requests

Have an idea for improving Cypht? We'd love to hear your suggestions!

Request Guidelines

  • Check if the feature already exists or is planned
  • Explain the problem your feature would solve
  • Describe the proposed solution clearly
  • Consider if it fits Cypht's modular design
  • Be open to discussion and feedback

Thank You!

Whether you're reporting a bug, suggesting a feature, or contributing code, your involvement helps make Cypht better for everyone. We appreciate your support!

On this page