# please do NOT tldr this - this is important. i know its boring but still.

## follow these steps provided to make your first contribution. welcome to the team 😋

<br>

# 🤝 Contributing to Project Toolsuite

Thank you for your interest in contributing! This project is built on the principle of **Privacy through Simplicity**. We welcome new tools, bug fixes, and documentation improvements.

---

## 1. 🌟 Support & Prepare

Before you start, please **Star** the repository to show your support. It helps the project grow and lets others find these tools!

### Star and Fork the Repo
To make changes, you need your own copy of the code:
1. On the repository homepage, look at the top right corner.

<img width="507" height="196" alt="image" src="https://github.com/user-attachments/assets/a2120aef-b738-4e35-99ff-5eb2654ffbaa" />


3. Click the **Star** button.
4. Click the **Fork** button. This creates a personal copy of this repo under your account.



---

## 2. 🚩 Raising an Issue

Found a bug or have a suggestion? Always check the "Issues" tab first.
* **To report a bug:** Open a [New Issue](https://github.com/Winter262005/Project-Toolsuite/issues) and describe what happened.
* **To suggest a tool:** Open an issue with the title `[Suggestion] Tool Name` and describe how it would work.

---

## 🛠️ 3. Your First Contribution: Add Your Name!

The easiest way to start is by adding your name to our `contributers.html` file.

### Step-by-Step Example:
1. Navigate to **your forked version** of the repository.
2. Click on the file named `contributers.html`.
3. Click the **Pencil Icon** (Edit this file) in the top right.
4. Scroll down to the `<ul class="contributors-list">` section.
5. Copy an existing `<li>` block and paste it at the bottom of the list with your information:

```html
<li>
    <span class="contributor-name">YOUR NAME</span>
    <a href="[https://github.com/YOUR-USERNAME](https://github.com/YOUR-USERNAME)" class="contributor-link" target="_blank">@YOUR-USERNAME</a>
</li>
```

6. Scroll down to Commit changes, type "Added myself to contributors list" as the message, and click Commit changes.


---

## 4. 🚀 Opening a Pull Request (PR)

Once you have committed changes to your fork, you need to send them back to the original project for review.
1. Go back to the **original repository** homepage.
2. You will see a yellow banner saying: *"This branch is X commits ahead of..."*
3. Click **Contribute** and then select **Open Pull Request**.
4. Review your changes one last time and click the green **Create pull request** button.



---

## 📜 Page Styling

Maintain uniformity if possible by using these styles

| Element Category | Property         | Specification                 | CSS Value / Implementation                             |   
|------------------|------------------|-------------------------------|--------------------------------------------------------|
| Typography       | Font Family      | Monospaced (Typewriter style) | Courier New, Courier, monospace                        |   
|                  | Body Size        | Standard readability          | 1rem or 16px                                           |   
|                  | Line Height      | Spacious for vertical clarity | 1.6                                                    |   
| Color Palette    | Primary          | Pure White                    | #FFFFFF                                                |   
|                  | Secondary        | Pure Black                    | #000000                                                |   
|                  | Accent           | Inversion                     | No colors; swap black & white on hover                 |   
| Borders          | Primary Border   | Thick & Structural            | 2px solid #000                                         |  
|                  | Header Underline | Heavy Anchor                  | 5px solid #000                                         |   
|                  | Feedback Box     | Technical / System readout    | 1px dashed #000                                        |   
| UI Components    | Buttons          | High Contrast                 | Border: 2px solid #000; Background: #FFF               |  
|                  | Button Hover     | Visual Flip                   | Background: #000; Color: #FFF                          |   
|                  | Input Fields     | Sharp & Boxy                  | border-radius: 0; padding: 10px;                       |   
|                  | Dropdowns        | Custom Minimalist             | -webkit-appearance: none; (Custom arrow)               |  
| Navigation       | Links            | Non-intrusive                 | text-decoration: none; border-bottom: 1px dotted #000; |   
|                  | Link Hover       | Bold Highlight                | background: #000; color: #fff;                         |   
| Spacing          | Page Margin      | Focused narrow column         | max-width: 800px; margin: 40px auto;                   |   
|                  | Section Gap      | Generous breathing room       | margin-bottom: 40px;                                   |   

---