Skip to content

codex-mohan/bitwork

 
 

Repository files navigation


🚀 About The Project

A significant portion of India's economic activity operates outside formal employment systems. Plumbers, electricians, domestic helpers, tutors, mechanics, small vendors, and students offering part-time services often lack access to structured marketplaces, physical shops, or stable employment contracts. Meanwhile, households, small businesses, and communities frequently need short-duration, task-specific work—not full-time hiring or long-term contracts.

Existing solutions focus on either full employment or gig marketplaces, which introduce high entry barriers, platform dependence, commissions, and rigid role definitions. There is a lack of systems that enable small, composable units of work to be exchanged flexibly, transparently, and locally.

🎯 The Problem

  • Informal workers lack visibility, digital presence, and proof of work without owning a shop or business
  • Small businesses and households often need short, specific tasks, not long-term hiring
  • Students and learners have limited opportunities to apply skills in real-world settings before formal employment
  • Existing platforms prioritize ratings, commissions, and long contracts, which discourage small-scale participation
  • Trust in informal work is built through word-of-mouth and is not portable across locations

💚 Social Responsibility & Ethics

  • Encourages fair access to work opportunities
  • Avoids exploitative gig dynamics
  • Supports inclusion of informal and unregistered workers
  • Promotes dignity of labor through contribution-based recognition

✨ Features

For Service Seekers

  • 🔍 Find Local Talent: Discover skilled workers in your area
  • 📝 Post Tasks: Create specific, short-duration job listings
  • 📊 Track Applications: Monitor and manage incoming applications
  • 🔔 Real-time Updates: Stay informed on job progress

For Skill Providers

  • 💼 Build Your Profile: Create a digital presence and showcase your work
  • 🎯 Find Opportunities: Access local, flexible work opportunities
  • 📈 Track Your Progress: Build a portable reputation across locations
  • 🏆 Gain Recognition: Earn credibility through completed tasks

🛠️ Tech Stack

Category Technologies
Framework Next.js 16, React 19
Language TypeScript 5.9
Styling Tailwind CSS v4
Database Drizzle ORM
Runtime Bun
Monorepo Turborepo

🚀 Getting Started

Prerequisites

  • Bun 1.3.9 or later
  • Node.js 20+ (for some tooling compatibility)

Installation

# Clone the repository
git clone https://github.com/yourusername/bitwork.git
cd bitwork

# Install dependencies
bun install

# Set up environment variables
bun run env

# Set up the database
bun run db:gen
bun run db:push

# Start the development server
bun run dev

The application will be available at http://localhost:3000


📜 Available Scripts

bun run dev          # Start development server
bun run build        # Build for production
bun run check-types  # Type checking
bun run check        # Lint & format code
bun run db:gen       # Generate database migrations
bun run db:push      # Push schema changes to database

📚 Documentation

For detailed technical documentation, see TECHNICAL.md which covers:

  • Architecture overview
  • Complete technology stack details
  • UI component library reference
  • Project structure details
  • Development workflow
  • Workspace dependencies

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

Please make sure to run bun run check before committing and follow the existing code style.


📝 License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with love

If you found this project helpful, please consider giving it a ⭐

About

Skill Exchange and Micro-Collaboration Network

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 98.2%
  • CSS 1.1%
  • Other 0.7%