Skip to content

DevyRuxpin/SampleWork

Repository files navigation

SampleWork Repository πŸš€

A portfolio of advanced software samples showcasing full-stack web development, AI integration, real-time systems, robust testing, and modern DevOps practices.

Crafted for maximum impact with clients and employers. This repository demonstrates expertise in JavaScript, Python, cutting-edge frameworks, and production-grade engineering.


Node.js React Python AI Powered License: MIT


πŸ—οΈ Overview

This repository presents a curated collection of production-ready projects and modules, including:

  • KaliShare: An AI-powered, real-time collaborative learning platform for web development.
  • Kali Social Media Scraper: An extensible, Python-based scraping and analytics tool with a planned web interface.
  • PibbyAPI: Requirements conversion API with robust test-driven development.
  • React Forms Exercises: Modern React form/state management demos.

Each project is documented, tested, and containerized for seamless deployment and code review.


πŸ–₯️ Tech Stack & Architecture

Languages

  • JavaScript (Node.js, React, Express)
  • Python (FastAPI, Scraper modules)
  • HTML5, CSS3, Shell scripting
  • PL/pgSQL (Postgres procedures)

Backend

  • Node.js 20+ / Express.js: Modular REST APIs, JWT authentication, Socket.io for real-time events
  • Python 3.10+: FastAPI web server, CLI tools, scraping & analytics engines
  • Databases: PostgreSQL (connection pooling, relational schema), SQLite (lightweight/local mode)
  • AI Integration: Hugging Face Qwen3-235B, fallback models, DuckDuckGo API

Frontend

  • React 18: Functional components, hooks, protected routing
  • CSS Modules: Modern styling, responsive layout
  • Socket.io-client: Live updates & collaboration
  • React Router v6: Client-side routing

DevOps / Deployment

  • Docker & docker-compose: Local and cloud deployments
  • Railway / Render Support: Ready-to-deploy configs
  • GitHub Actions: CI/CD workflows, linting, and automated testing

Testing & QA

  • Jest: Unit/integration testing for Node.js backend
  • React Testing Library: Frontend coverage
  • Mocking: DB, API, and JWT mocks for robust test reliability
  • Coverage targets: 80–90%+ in critical layers

🌟 Key Features

πŸ€– AI-Powered Q&A (KaliShare)

  • Qwen3-235B LLM for web/dev questions (JavaScript, React, CSS, Node.js, DBs)
  • Multi-fallback: DuckDuckGo, legacy models, local KB
  • Markdown-formatted, real-time answers
  • Smart caching & rate limiting

πŸ“š Educational Resource Hub

  • 100+ hand-picked links: MDN, freeCodeCamp, official docs, tutorials
  • Auto-updated via RSS (Dev.to, SmashingMag, CSS Tricks)
  • Search & filter by category (Languages, Frontend, Backend, DevOps)

πŸ’¬ Real-Time Timeline & Collaboration

  • Socket.io-powered messaging, posts, and comments
  • User presence & online status
  • Livestream integration: YouTube, Twitch, Zoom, Google Meet

πŸ” Advanced Search

  • Multi-platform (DuckDuckGo, Stack Overflow, GitHub, RSS feeds)
  • Cached server-side for ultra-fast results
  • Smart suggestions & topic filtering

πŸ”’ Security & Authentication

  • JWT-based login/signup, bcrypt password hashing
  • Strict CORS, rate limiting, data validation throughout

πŸ“ˆ Analytics & Monitoring

  • Google Analytics 4 integration
  • Built-in performance and error monitoring

⚑ Quick Start

Prerequisites

  • Node.js >= 20
  • Python >= 3.10
  • Docker (for containerized deployment)
  • PostgreSQL (cloud or local)
  • [Optional] Hugging Face API key

Installation

# Clone the repository
git clone https://github.com/DevyRuxpin/SampleWork.git
cd SampleWork

# Backend setup
cd KaliShare/backend
npm install

# Frontend setup
cd ../frontend
npm install

# Python Scraper
cd ../../KaliSocialMediaScraper
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Environment Variables

See KaliShare/docs/RAILWAY_SETUP.md for a complete list.
Typical .env for backend:

PORT=5000
NODE_ENV=production
JWT_SECRET=your-super-secret-jwt-key
DATABASE_URL=postgresql://user:password@host:port/database
HUGGING_FACE_API_KEY=your_hugging_face_api_key

Run Locally

# Start backend (from KaliShare/backend)
npm start

# Start frontend (from KaliShare/frontend)
npm start

# Access frontend: http://localhost:3000
# Access API: http://localhost:5000/api/

Or use Docker:

docker-compose up --build

πŸ“– Documentation


πŸ§‘β€πŸ’» Example AI Q&A

  • "How do I use async/await in JavaScript?"
  • "What are React hooks and how do I use them?"
  • "How do I set up PostgreSQL or MongoDB?"
  • "What is CSS Grid and how do I use it?"

πŸ§ͺ Testing & Quality

  • Backend: Jest + custom config, 90%+ coverage
  • Frontend: React Testing Library, 85%+ coverage
  • CI/CD: Automated with GitHub Actions
  • Mocking: DB, API, JWT, and network layers

πŸ—‚οΈ Project Structure

Click to expand
SampleWork/
β”œβ”€β”€ KaliShare/
β”‚   β”œβ”€β”€ backend/         # Node.js API, Express, Socket.io
β”‚   β”œβ”€β”€ frontend/        # React 18 app, CSS Modules
β”‚   β”œβ”€β”€ docs/            # All documentation and guides
β”‚   β”œβ”€β”€ docker-compose.yml
β”‚   β”œβ”€β”€ Dockerfile
β”‚   └── railway.json
β”œβ”€β”€ KaliSocialMediaScraper/
β”‚   β”œβ”€β”€ scraper/         # CLI and scraping logic (Python)
β”‚   β”œβ”€β”€ web/             # FastAPI backend, planned React frontend
β”‚   └── docs/
β”œβ”€β”€ PibbyAPI/            # Requirements conversion API (Python)
β”œβ”€β”€ react-forms/         # React forms and testing exercises
└── ...

🌱 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to your branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ™ Acknowledgments


πŸ›‘οΈ License

This project is licensed under the MIT License. See LICENSE for details.


SampleWork – Modern software samples, ready for review and deployment.
Contact: DevyRuxpin@gmail.com | Freelancer.com profile


About

A portfolio of software samples

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published