docs: update wordings and text content

Author: weaponsforge

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -17,7 +17,7 @@ body:
       label: To Reproduce
       description: A step-by-step description of how to reproduce the issue, or a link to the reproducible repository.
       placeholder: |
-        1. Start the application in development (`npm run sendemail:dev -- text -s "Title" -c "Sample body" -r a@gmail.com`)
+        1. Start the application in development (npm run sendemail:dev -- text -s "Title" -c "Sample body" -r a@gmail.com)
         2. Press enter
         3. An error appears: "[ERROR] Failed to send text email: Required clientId"
     validations:

CONTRIBUTING.md

@@ -2,6 +2,19 @@
 
 Welcome to the **send-email** repository! We're excited to have you contribute to sending text and HTML-format emails more accessible via command line interface (CLI). To ensure a smooth contribution process for everyone, please follow these guidelines.
 
+> [!NOTE]
+>  **Before Submitting**
+>
+> Check if there are other similar [PRs](https://github.com/weaponsforge/send-email/pulls).
+>
+> **New Feature**
+>
+> Before submitting a new feature, please open a **Feature Request issue** that clearly explains the proposed functionality and the reasons behind it. Once the request has been reviewed and approved, you may proceed with submitting a pull request.
+>
+> **Bug Fixes**
+>
+> Provide a detailed description of the bug (with live demo if possible). OR open a bug report and link it in your PR.
+
 ## Getting Started
 
 1. **Fork the Repository:** Start by forking the repository's `"dev"` branch to your GitHub account. This creates your own copy of the project where you can make changes.
@@ -64,4 +77,4 @@ Welcome to the **send-email** repository! We're excited to have you contribute
 
 4. **Respect:** Respect the structure and formatting of the existing project. Follow the standard ESLint rules defined in its `app/eslint.config.mjs` file.
 
-Thank you for contributing to the **send-email** repository. Your efforts help in sending emails more accessible for everyone.
+Thank you for contributing to the **send-email** repository. Your efforts help in making sending emails more accessible for everyone.

README.md

@@ -39,7 +39,7 @@ NPM library and CLI for sending text and HTML emails using Gmail SMTP with Googl
    ```text
    Recommended:
    node: 24.11.0
-   npm: 10.9.2
+   npm: 11.6.1
    ```
 3. Gmail Account
    - Google Cloud Platform project configured with [OAuth2](https://developers.google.com/workspace/guides/configure-oauth-consent) settings and [credentials](https://developers.google.com/workspace/guides/manage-credentials)
@@ -72,6 +72,7 @@ We welcome contributions! Please see [CONTRIBUTING.md](/CONTRIBUTING.md) and the
    - See **Installation # 4** for more information about these environment variables.
 2. Install dependencies.
    ```bash
+   cd app
    npm install
    ```
 3. Transpile to JavaScript.
@@ -184,7 +185,7 @@ We welcome contributions! Please see [CONTRIBUTING.md](/CONTRIBUTING.md) and the
    docker run -it -v ${pwd}/app:/opt/app -v /opt/app/node_modules --rm weaponsforge/sendemail:dev <AVAILABLE_SCRIPT_OR_DOCKER_SCRIPT>
    ```
 
-- **Run a non-test TS file using Vite**<br>
+- **Run a non-test TS file using TypeScript Execute (tsx)**<br>
    (requires **Run an NPM script using Docker compose**)
    ```bash
    docker exec -it weaponsforge-sendemail-dev npx tsx /opt/app/src/<PATH_TO_TS_FILE>.ts
@@ -375,8 +376,8 @@ Sends text and HTML emails using the command line interface (CLI) with transpile
    Options:
    -s, --subject <title>      email subject or title enclosed in double-quotes
    -r, --recipients <emails>  comma-separated list of email addresses
-   -c, --content <text...>    whitespace-delimited of text/paragraphs enclosed in double-quotes
-   -w, --wysiwyg [html]       optional HTML tags that form a WYSIWYG content enclosed in double-quotes
+   -c, --content <text...>    whitespace-delimited text/paragraphs enclosed in double-quotes
+   -w, --wysiwyg [html]       optional HTML tags that form a WYSIWYG content enclosed in double-quotes, using inline CSS styles
    -e, --env [path]           path to .env file (optional)
    -h, --help                 display help for command
    ```

app/src/lib/email/sender.ts

@@ -41,7 +41,7 @@ class EmailSender extends EmailTransport implements IEmailSender {
       }
 
       return await this.transporter!.sendMail({
-        from: transportOptions.auth?.user || process.env.USER_EMAIL,
+        from: transportOptions.auth?.user || process.env.GOOGLE_USER_EMAIL,
         to: receivers,
         subject,
         ...(!isHtml && { text: content }),  // Text email

app/src/scripts/cli/lib/meta.ts

@@ -44,11 +44,11 @@ const CLI_ARGS = {
   CMD_HTML: {
     CONTENT_HTML: {
       OPTION: '-c, --content <text...>',
-      DESCRIPTION: 'whitespace-delimited of text/paragraphs enclosed in double-quotes'
+      DESCRIPTION: 'whitespace-delimited text/paragraphs enclosed in double-quotes'
     },
     CONTENT_WYSIWYG: {
       OPTION: '-w, --wysiwyg [html]',
-      DESCRIPTION: 'optional HTML tags that form a WYSIWYG content enclosed in double-quotes'
+      DESCRIPTION: 'optional HTML tags that form a WYSIWYG content enclosed in double-quotes, using inline CSS styles'
     },
     TEMPLATE_FILE: {
       OPTION: '-t, --template [path]',

docs/CODING_STYLE.md

@@ -47,8 +47,8 @@ It follows the directory structure within the `/app` directory:
 **What you should (and shouldn't) edit**
 
 ✅ **Edit:**
-- `src/**` (main TypeScript source)
-- Top-level build scripts in `scripts/**` (bash / automation)
+- `app/src/**` (main TypeScript source)
+- Top-level build scripts in `app/scripts/**` (bash / automation)
 
 🏗️🚫 **Auto-generated (do not edit):**
 - `dist/**` (TS build output; local, published to NPM)
@@ -72,7 +72,7 @@ Do not edit manually.
 
 #### 📂 scripts
 
-Contains Build automation scripts (bash)
+Contains build automation scripts (bash)
 
 #### 📂 src
 
@@ -160,7 +160,7 @@ This folder contains the [EJS](https://github.com/mde/ejs) HTML template used in
 - Place test files in the `/src/__tests__` directory.
 - Name test files to match the target module, using the suffix: `*.test.ts`.
    > **Example:** `send.ts` → `send.test.ts`
-- **Selectively write tests** for critical or global, features, or business logic as needed.
+- **Selectively write tests** for critical or global features, or business logic as needed.
 - All code should pass `"npm test"` before commit.
 
 @weaponsforge<br>

docs/README_NPM.md

@@ -29,12 +29,14 @@ NPM library for sending text and HTML emails using Gmail SMTP with Google OAuth2
    ```text
    Recommended:
    node: 24.11.0
-   npm: 10.9.2
+   npm: 11.6.1
    ```
 2. Gmail Account
    - Google Cloud Platform project configured with [OAuth2](https://developers.google.com/workspace/guides/configure-oauth-consent) settings and [credentials](https://developers.google.com/workspace/guides/manage-credentials)
    - Read on the Google [Gmail](https://developers.google.com/gmail/api/guides), [SMTP and OAuth2 Setup](https://github.com/weaponsforge/email-sender?tab=readme-ov-file#using-the-oauth-20-playground) sections for more information
 
+3. A `.env` file containing the environment variables described under **Quickstart - step #2**.
+
 ### Core Libraries/Frameworks
 
 (Installed via npm)