npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

labor-workforce-platform

v1.0.4

Published

Platform for labor workforce registration and profile management

Readme

Labor Workforce Platform

A full-stack web application where multiple users can register as labor workforce and create personal profiles with their skills, hourly rates, and work portfolio (photos/videos).

Features

  • User Registration & Authentication: Secure user registration and login system
  • Profile Management: Create and edit personal profiles with:
    • Name and address
    • Places of operation (cities/provinces you serve)
    • Skills with individual hourly rates (₱ per skill)
    • Dedicated profile picture + work portfolio (photos and videos)
  • Browse Workers: View all registered workers and their profiles
  • File Upload: Upload photos and videos as proof of work
  • Booking System: Book services with skill selection, date picker, and email notifications
  • Modern UI: Beautiful, responsive design with gradient backgrounds

Tech Stack

Backend

  • Node.js with Express
  • SQLite database
  • JWT authentication
  • Multer for file uploads
  • bcryptjs for password hashing
  • Nodemailer for email notifications

Frontend

  • React
  • Axios for API calls
  • Modern CSS with gradients and animations

Installation

  1. Install backend dependencies:

    npm install
  2. Install frontend dependencies:

    cd client
    npm install
    cd ..

    Or install all at once:

    npm run install-all

Running the Application

Development Mode

  1. Start the backend server:

    npm run dev

    The server will run on http://localhost:5000

  2. Start the frontend (in a new terminal):

    npm run client

    The frontend will run on http://localhost:3000

Production Mode

  1. Build the frontend:

    npm run build
  2. Start the server:

    npm start

API Endpoints

Authentication

  • POST /api/auth/register - Register a new user
  • POST /api/auth/login - Login user

Profile

  • GET /api/profile/me - Get current user's profile (requires auth)
  • POST /api/profile/create - Create or update profile (requires auth)
  • DELETE /api/profile/me - Delete current user's profile including media (requires auth)
  • GET /api/profile/all - Get all profiles
  • GET /api/profile/:id - Get profile by ID

Upload

  • POST /api/upload/media - Upload photo/video (requires auth)
  • DELETE /api/upload/media/:id - Delete media file (requires auth)
  • POST /api/upload/profile-picture - Upload or update profile photo (requires auth)

Booking

  • POST /api/booking/create - Create a new booking request
  • GET /api/booking/profile/:profileId - Get all bookings for a profile

Environment Variables

Create a .env file in the root directory:

PORT=5000
JWT_SECRET=your-secret-key-change-in-production
[email protected]
EMAIL_PASSWORD=your-app-password

Note: For email notifications to work, you need to configure EMAIL_USER and EMAIL_PASSWORD.

  • For Gmail, you'll need to use an App Password instead of your regular password.
  • If email credentials are not configured, bookings will still be saved but email notifications will not be sent.

Database

The application uses SQLite database which is automatically created in server/database/database.sqlite on first run.

File Storage

Uploaded files are stored in server/uploads/ directory. Make sure this directory has write permissions.

Usage

  1. Register a new account
  2. Login with your credentials
  3. Create your profile with name, address, places of operation, and skill-specific hourly rates (₱)
  4. Upload a profile photo to personalize your card (optional but recommended)
  5. Upload photos or videos as proof of your work
  6. Browse other workers' profiles
  7. Book services by clicking "Book Service" on any worker's profile, selecting a skill, choosing a date, and providing your contact information

Notes

  • Passwords are hashed using bcryptjs
  • JWT tokens expire after 7 days
  • File upload limit is 50MB
  • Supported file types: jpeg, jpg, png, gif, mp4, mov, avi, webm