Skip to content

ehgzao/Shipper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

217 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿšข Shipper

๐ŸŒ Live: shipper.works

Shipping opportunities for Product People

The job tracker built for Product People who believe in quality over quantity.

License React Supabase TypeScript

๐ŸŽฏ What is Shipper?

Shipper is a curated job hunting tool designed for Product Managers tired of the "spray and pray" approach. Instead of mass-applying to hundreds of jobs, Shipper helps you focus on opportunities that truly match your profile.

The Problem

  • ๐Ÿ“Š Chaos everywhere โ€” Spreadsheets, notes, and emails scattered around
  • ๐ŸŽฏ Mass-applying fails โ€” 100 applications, 0 responses
  • ๐Ÿค– AI spam gets filtered โ€” Fully AI-written applications are detected and ignored

The Solution

  • ๐Ÿข Curated company database โ€” 60 pre-selected companies across 6 countries
  • ๐Ÿ“‹ Visual pipeline โ€” Kanban board to track from research to offer
  • โญ Fit tracking โ€” Rate your fit for each role to prioritize effectively
  • ๐Ÿท๏ธ Smart tagging โ€” Mark high priority, referrals, and dream jobs
  • ๐Ÿ“Š Analytics โ€” Track conversion rates, pipeline health, and trends
  • ๐Ÿค– AI Coach โ€” Personalized tips (suggestions, not ghostwriting)

โœจ Features

๐Ÿ“‹ Pipeline Tracking

Track opportunities through 6 stages:

Stage Description
Researching Analyzing the opportunity
Applied Application submitted
Interviewing In conversation with company
Assessment Technical tests, case studies
Offer Received an offer ๐ŸŽ‰
Archived Rejected, ghosted, or withdrawn

๐Ÿข Target Companies

  • 60 pre-populated companies across Portugal, Brazil, Germany, Spain, Ireland, and Netherlands
  • Add custom target companies
  • Track when you last checked each company's careers page

๐Ÿ“Š Analytics Dashboard

  • By Role โ€” See which roles you're applying to most
  • By Country โ€” Geographic distribution of your applications
  • By Status โ€” Pipeline health and conversion visualization

๐Ÿค– AI Coach (Powered by Groq)

Get personalized tips for each application:

  • Cover letter suggestions
  • CV highlights to emphasize
  • Company research angles

Suggestions, not substitutions. You stay authentic.

๐Ÿ” Security

  • Two-Factor Authentication (2FA) โ€” Secure your account
  • Row Level Security โ€” Your data is isolated and protected

๐ŸŒ™ Dark Mode

Full dark theme support for late-night job hunting sessions.

๐Ÿ› ๏ธ Tech Stack

Layer Technology
Frontend React 18 + TypeScript
Styling Tailwind CSS + shadcn/ui
Backend Supabase (Auth, Database, Edge Functions)
AI Groq API (Llama 3.3 70B)
Deployment Netlify

๐Ÿš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Supabase account
  • Groq API key (free tier available)

Installation

# Clone the repository
git clone https://github.com/ehgzao/shipper.git
cd shipper

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local

# Run development server
npm run dev

Environment Variables

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

For AI Coach functionality, add GROQ_API_KEY to Supabase Edge Function secrets.

๐Ÿ“ Project Structure

shipper/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/       # React components
โ”‚   โ”‚   โ”œโ”€โ”€ ui/           # shadcn/ui components
โ”‚   โ”‚   โ”œโ”€โ”€ pipeline/     # Pipeline-specific components
โ”‚   โ”‚   โ””โ”€โ”€ landing/      # Landing page components
โ”‚   โ”œโ”€โ”€ hooks/            # Custom React hooks
โ”‚   โ”œโ”€โ”€ lib/              # Utilities and Supabase client
โ”‚   โ”œโ”€โ”€ pages/            # Page components
โ”‚   โ””โ”€โ”€ types/            # TypeScript types
โ”œโ”€โ”€ supabase/
โ”‚   โ”œโ”€โ”€ functions/        # Edge Functions (AI Coach)
โ”‚   โ””โ”€โ”€ migrations/       # Database migrations
โ””โ”€โ”€ public/               # Static assets

๐Ÿ—„๏ธ Database Schema

Table Description
profiles User profile and preferences
target_companies Companies the user is tracking
opportunities Job opportunities in the pipeline
preset_companies Pre-populated company database

๐ŸŒ Supported Countries

Country Companies
๐Ÿ‡ต๐Ÿ‡น Portugal 10
๐Ÿ‡ง๐Ÿ‡ท Brazil 10
๐Ÿ‡ฉ๐Ÿ‡ช Germany 10
๐Ÿ‡ช๐Ÿ‡ธ Spain 10
๐Ÿ‡ฎ๐Ÿ‡ช Ireland 10
๐Ÿ‡ณ๐Ÿ‡ฑ Netherlands 10

๐Ÿค Contributing

Contributions are welcome!

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

๐Ÿ“„ License

This project is licensed under the MIT License โ€” see the LICENSE file for details.

๐Ÿ™ Acknowledgments


Made with โ˜• in Porto by Gabriel Lima

About

Quality-first job tracker for Product Managers. Kanban pipeline, AI coach, 60+ curated companies across 6 countries.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors