🚀 ThinkRED Technologies Monorepo

Simplify Technology & Experience ✨

Complete monorepo for ThinkRED Technologies company website and infrastructure

Where Engineering Excellence Meets Creative Innovation 🎯

---

🌟 What Makes Us Different

This monorepo houses the complete digital ecosystem for ThinkRED Technologies - where we transform complex technological challenges into elegant, scalable solutions. Built with modern technologies and engineering best practices, this serves as the primary digital presence for our technology consultancy.

ThinkRED Technologies LLP - Founded by seasoned engineers from Mozilla, Fedora, and Red Hat, we bring enterprise-grade engineering expertise to every project. Think Different. Build Better. Deploy Smarter. 🔥

---

Technology Stack

Frontend Stack Modern Frontend Development React 19 with TypeScript for type safety Vite for lightning-fast builds and HMR Tailwind CSS for utility-first styling React Router for client-side navigation React Markdown for documentation rendering ESLint and Prettier for code quality

Backend Stack Serverless Backend Google Apps Script for serverless execution Google Sheets for structured data storage Google Drive for file management Gmail API for notifications CLASP for deployment automation

---

Repository Structure

thinkred-monorepo/
├── frontend/               # React frontend application
│   ├── src/               # Source code and components
│   ├── public/            # Static assets and HTML templates
│   ├── docs/              # User-facing documentation (copied from /docs)
│   ├── scripts/           # Build and optimization scripts
│   ├── vite.config.ts     # Vite configuration
│   └── package.json       # Frontend dependencies and scripts
├── backend/               # Google Apps Script backend
│   ├── thinkREDBot.js     # Main backend logic and API endpoints
│   ├── deploy.js          # Deployment automation
│   └── package.json       # Backend dependencies
├── docs/                  # Developer and technical documentation
│   ├── developer/         # Technical guides and API docs
│   ├── operations/        # DevOps and operational guides
│   ├── content/           # Content management documentation
│   └── templates/         # Documentation templates
├── scripts/               # Monorepo automation and tools
│   ├── task-runner.js     # Unified task management system
│   ├── deploy/            # Deployment scripts
│   ├── performance/       # Performance optimization tools
│   ├── security/          # Security validation tools
│   └── utils/             # Utility scripts and helpers
├── reports/               # Automated reports and analytics
│   ├── automated/         # Generated health and status reports
│   ├── operational/       # Operational improvement reports
│   ├── security/          # Security audit reports
│   └── performance/       # Performance analysis reports
└── README.md              # This file

---

✨ What We've Built (And What Makes Us Proud)

Feature	Description	Status	ThinkRED Touch
Responsive Design	Mobile-first, cross-device	✅ Active	Looks great everywhere
Contact Forms	Smart contact and applications	✅ Active	Intelligent & intuitive
Blog System	Markdown-based content	✅ Active	Write once, publish beautifully
Admin Dashboard	Job management interface	✅ Active	Control center mastery
Performance	Optimized loading and metrics	✅ Active	Lightning fast 97-100 PageSpeed
Security	CSP headers and validation	✅ Active	Fort Knox level protection
SEO Optimization	Search engine optimized	✅ Active	Google loves us
Documentation	Comprehensive guides	✅ Active	Everything explained beautifully
Automated Deployment	CI/CD with quality checks	✅ Active	Deploy with confidence
Monitoring	Health checks and reporting	✅ Active	We know before you do

🎯 Fun Fact: We achieved enterprise-grade performance scores (97-100/100 on PageSpeed) while maintaining a beautiful, functional design. That's the ThinkRED difference! | 📱 Responsive Design | Optimized for all device sizes | ✅ Active |

| 📝 Form Processing | Contact forms and job applications | ✅ Active |

| 📎 File Upload | Resume uploads for job applications | ✅ Active |

| 📧 Email Notifications | Automated email handling | ✅ Active |

| 📚 Documentation System | Markdown-based docs via web interface | ✅ Active |

| 🔍 SEO Optimized | Built for search engine visibility | ✅ Active |

---

⚡ Quick Start

Ready to dive into the ThinkRED universe? Let's get you up and running in under 5 minutes! 🚀

Prerequisites

• Node.js 18+ (LTS recommended) - The foundation of modern web development
• npm 8+ for package management - Your dependency superhero
• Git for version control - Because time travel should be easy

Installation & Setup

# Clone the repository (grab the source of awesomeness)
git clone https://github.com/thinkredtech/thinkredtech.github.io.git
cd thinkred-monorepo

# Install all dependencies (monorepo magic ✨)
npm install

# Start development server (where the magic happens)
npm run dev

# View at http://localhost:3000 (your new playground)

Key Commands

# 🚀 Development Commands
npm run dev              # Start frontend development server
npm run dev:all          # Start all development services (full power mode)

# 🏗️ Building Commands
npm run build            # Build frontend for production
npm run build:all        # Build all components (everything, everywhere)

# 🔍 Quality Assurance Commands
npm run qa               # Run complete quality pipeline (the works)
npm run lint             # Lint code across all workspaces
npm run test             # Run test suites (confidence booster)

# 🚀 Deployment Commands
npm run deploy           # Deploy to production (ship it!)
npm run deploy:frontend  # Deploy frontend only (focused launch)
npm run deploy:backend   # Deploy backend only (API power)

# 🎛️ Task Management Commands
npm run task --help      # Show all available tasks (your command center)
npm run status           # Show workspace status (system health check)

💡 Pro Tip: All commands work from the root directory thanks to our unified task management system. No more directory hopping! 🎯

---

🎯 Quality Assurance Pipeline

NEW! Comprehensive quality checks with a single command:

## 🛡️ Run ALL quality checks (lint, test, security, performance, build)
npm run qa

## � Fix common issues and run QA
npm run qa:fix

## �📊 Alternative commands
npm run quality          # Alias for qa
npm run check           # Alias for qa
npm run validate        # Alias for qa

What gets tested:

• 📦 Dependencies & package integrity
• 📝 Code linting (ESLint, Markdown, Links)
• 💅 Code formatting (Prettier)
• 🔤 TypeScript type checking
• 🧪 Unit tests
• 🛡️ Security audits & sensitive data scans
• 🏗️ Build validation
• 📊 Performance testing (GTMetrix 83%, Lighthouse)
• 🔍 Documentation quality & health checks

Quality Score: 92.6% (EXCELLENT!)

---

🎛️ Unified Task Management

This monorepo features a unified task management system that simplifies development workflows:

## 📋 Show all available commands
npm run help

## 🚀 Development commands
npm run dev              # Start frontend development
npm run dev:all          # Start all development servers
npm run build            # Build frontend
npm run build:all        # Build everything

## 🔍 Code quality
npm run qa               # 🎯 Complete QA pipeline (NEW!)
npm run lint             # Lint all workspaces
npm run format           # Format all code
npm run type-check       # TypeScript checking
npm run lint:md          # Check markdown formatting
npm run docs:quality     # Full documentation quality check
npm run docs:dashboard   # Generate documentation health dashboard

## 📊 Performance optimization
npm run perf:gtmetrix:enhanced  # 🚀 GTMetrix 83% score (NEW!)
npm run perf:gtmetrix           # Standard GTMetrix optimization
npm run perf:test               # Lighthouse performance testing
npm run perf:validate           # Pre-deployment validation

## 🚢 Deployment
npm run deploy           # Deploy to production
npm run deploy:frontend  # Deploy frontend only
npm run deploy:backend   # Deploy backend only

## 📊 Monitoring
npm run status           # Show workspace status
npm run backend:logs     # View backend logs

🎯 Key Benefits

• 🎯 Single Entry Point: All tasks run from root directory
• ⚡ Parallel Execution: Multiple tasks run simultaneously when safe
• 🧠 Context Aware: Automatically runs tasks in correct workspace
• 🔍 Clear Visibility: See exactly what's running where

📖 Complete Guide: docs/TASK_MANAGEMENT.md | 📋 Quick Ref: TASKS.md

---

🚀 Deployment

🌐 Frontend Deployment Primary: GitHub Pages (automatic) Secondary: Hostinger (zero-downtime deployment) 📖 Zero-Downtime Guide: docs/ZERO_DOWNTIME_DEPLOYMENT.md

⚡ Backend Deployment Platform: Google Apps Script Tool: CLASP CLI

---

📚 Documentation Universe

Everything you need to know, beautifully organized and thoroughly explained. ✨

🎯 For Users

Documentation	Description	Access
Website Overview	Platform introduction and features	/docs/website-overview
Company Information	About ThinkRED Technologies	/docs/company-info
Brand Guidelines	Visual identity and style guide	/docs/brand-guidelines
FAQ	Frequently asked questions	/docs/faq

🛠️ For Developers

Documentation	Description	Link	Why You'll Love It
Setup Guide	Complete installation and environment setup	Installation Guide	Get started in minutes, not hours
Development Workflow	Development practices and task management	Development Guide	Streamlined development experience
Architecture Overview	System design and technical architecture	System Overview	Understand the big picture
API Documentation	Backend APIs and integration guide	API Reference	Everything you need to integrate
Deployment Guide	Production deployment procedures	Deployment Guide	Deploy with confidence
Task Management	Unified task runner and development workflows	Task Management	One command to rule them all
Troubleshooting	Common issues and solutions	Troubleshooting Guide	When things don't go as planned

💡 Documentation Philosophy: We believe great documentation is like great code - clear, comprehensive, and enjoyable to work with. Every guide is crafted with love. 💝

---

🤝 Contributing

We welcome contributions! Please read our guidelines:

• 📋 Contributing Guidelines: Contributing Guide - Code standards, workflow, and PR process
• 🤝 Code of Conduct: CODE_OF_CONDUCT.md - Community standards and expectations
• � License: LICENSE - Usage terms and attribution requirements

---

🛠️ Project Scripts

🎨 Frontend Scripts

Command	Description
npm run dev	🚀 Start development server
npm run build	🏗️ Build for production
npm run preview	👀 Preview production build
npm run deploy	🌐 Deploy to GitHub Pages
npm run deploy:github	🚀 Deploy to GitHub Pages
npm run deploy:ssh	🔒 Deploy to Hostinger via SSH
npm run lint	🔍 Run ESLint
npm run type-check	✅ TypeScript compiler check

🧠 Backend Scripts

Command	Description
npm run push	📤 Push to Google Apps Script
npm run deploy	🚀 Deploy to Google Apps Script
npm run logs	📊 View execution logs

---

⚙️ Environment Configuration

Frontend Environment Variables

Create a .env file in the frontend/ directory:

VITE_API_URL=https://script.google.com/macros/s/YOUR_DEPLOYMENT_ID/exec

Backend Configuration

Configuration is managed through Google Apps Script Properties Service.

---

🆘 Support

For technical issues or questions:

1. 📖 Check Documentation: Review the relevant docs first
2. 🔍 Troubleshooting Guide: Check our troubleshooting guide
3. 🐛 Create Issue: Open a detailed GitHub issue if problems persist

---

📄 License

This project is licensed under a custom license that requires attribution to ThinkRED Technologies LLP.

Key Requirements:

• ✅ Attribution required for any use or derivative work
• ✅ Credit must be given to ThinkRED Technologies LLP
• ✅ Original license must be preserved

See the LICENSE file for complete terms and conditions.

---

📞 Contact

🚀 ThinkRED Technologies LLP

Contact us through our website contact form

---

Built with ❤️ by the ThinkRED Technologies team

"Simplify Technology & Experience"