Cross-platform Employee Onboarding System Development

Portfolio project

Employee Onboarding System

A cross-platform desktop utility for automated batch employee onboarding via Google Workspace. Installs directly to your system application menu (Start Menu on Windows, Application Grid on Linux) for seamless access.

📧 Contact: joelclouds@gmail.com 🔗 Repository: github.com/joelclouds/EmployeeOnboardingSystem 🌍 Platform: Windows & Linux

🚀 Quick Start: Install Dependencies

Before cloning the repository, ensure your system has Python 3.10+ and Git installed.

🪟 Windows

Install Git: Download from git-scm.com.

Install Python: Download Python 3.10+ from python.org.

⚠️ Critical: Check "Add Python to PATH" during installation.

Verify: Open Command Prompt (cmd) and run:

python --version
git --version

🐧 Linux (Debian/Ubuntu)

Run this single command to install all required system dependecies:

sudo apt update && sudo apt install -y python3-full git

📥 Installation & Management

Clone the repository first:

git clone https://github.com/joelclouds/EmployeeOnboardingSystem.git
cd EmployeeOnboardingSystem

1. Fresh Install

Installs dependencies and registers the app in your system menu.

Windows: python setup.py --fresh

Linux: python3 setup.py --fresh

Look for "Employee Onboarding System" in your Start Menu or App Grid.

2. App Update

Pulls latest code and updates dependencies while preserving your menu shortcut.

Windows:

git pull
python setup.py

Linux:

git pull
python3 setup.py

3. Uninstallation

Removes dependencies, deletes the system menu shortcut, and cleans the project folder.

Windows:

python setup.py --uninstall
cd ..
rmdir /s /q EmployeeOnboardingSystem

Linux:

python3 setup.py --uninstall
cd ..
rm -rf EmployeeOnboardingSystem

4. Manual Run (Optional)

Run without installing to the menu (for debugging):

Windows: python -m src.ui.app

Linux: python3 -m src.ui.app

🔐 First Run Configuration

Launch the app from your System Application Menu (or via CLI).

Click ☰ Show Settings.

Enter your EMPLOYEE_GOOGLE_SHEET_URL and verify column headers.

Click 💾 Save & Apply (triggers live validation).

Click 🚀 Start Batch Onboarding.

A browser window will open for Google OAuth authentication.

Grant permissions to generate token.pickle.

📬 Support

For issues, feature requests, or enterprise licensing: Email: joelclouds@gmail.com Please include: Operating System, Python version, and the full error traceback.

0 likes · 12 views · Mar 19, 2026

Developed a cross-platform employee onboarding system using Google Workspace.

Timeline

Mar 10, 2026 - Mar 13, 2026