contractorsUy

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 21 Open GitHub ↗

A tool that streamlines the transition from employment to independent contracting for software developers.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![GitHub Contributors](https://img.shields.io/github/contributors/andy-viera/contractorsUy?style=for-the-badge)](https://github.com/andy-viera/contractorsUy/graphs/contributors)
[![GitHub Forks](https://img.shields.io/github/forks/andy-viera/contractorsUy?style=for-the-badge)](https://github.com/andy-viera/contractorsUy/network/members)
[![GitHub Stars](https://img.shields.io/github/stars/andy-viera/contractorsUy?style=for-the-badge)](https://github.com/andy-viera/contractorsUy/stargazers)
[![GitHub Issues](https://img.shields.io/github/issues/andy-viera/contractorsUy?style=for-the-badge)](https://github.com/andy-viera/contractorsUy/issues)

</div>

<br />
<div align="center">
  <img src="public/readme_accountant.webp" alt="Accountant Working with Software Engineers" height="300px">
  <br/>
  <br/>
<i>A tool that streamlines the transition from employment to independent contracting for software developers.</i>
  <br/>
  <br/>
  <h1><i>contractorsUy</i></h1>

<p align="center">
    <a href="https://contractorsuy.aviera.me/"><strong><u>Check it out »</u></strong></a>
    <br/>
    <br/>
    <a href="https://github.com/andy-viera/contractorsUy/issues/new?labels=enhancement"><u>Suggest a Feature</u></a>
    ·
    <a href="https://github.com/andy-viera/contractorsUy/issues/new?labels=bug"><u>Report a Bug</u></a>
  </p>
</div>

<details>
  <summary>Table of Contents</summary>
  <ol>
    <li>
      <a href="#overview">Overview</a>
      <ul>
         <li><a href="#features">Features</a></li>
         <li><a href="#technologies">Technologies</a></li>
      </ul>
    </li>
    <li>
      <a href="#contributing">Contributing</a>
      <ul>
        <li><a href="#reporting-bugs--suggesting-enhancements">Reporting Bugs & Suggesting Enhancements</a></li>
        <li><a href="#fixing-issues">Fixing Issues</a></li>
        <li><a href="#setting-up-locally">Setting Up Locally</a></li>
      </ul>
    </li>
    <li><a href="#get-in-touch">Get in Touch</a></li>
  </ol>
</details>

## Overview

**_ContractorsUy_** is an open-source tool designed to help software developers in Uruguay transition from employees to independent contractors. It provides a detailed simulator and guide to help developers understand how taxes impact their earnings and how to optimize their financial strategies, whether they work for international or local companies.

### Features

- Simulator: Estimate your optimal contractor's salary based on your current legal status and current salary as dependant employee.
- Contractor's Guide: Detailed explanations of tax structures and legal considerations for the software industry.

### Technologies

**Frontend:**

- [TypeScript](https://www.typescriptlang.org/)
- [React.js](https://react.dev/)
- [Vite](https://vite.dev/)
- [TailwindCSS](https://tailwindcss.com/)
- [React Hook Form](https://react-hook-form.com/)
- [Motion](https://motion.dev/)
- [Aceternity UI](https://www.aceternity.com/components)
- [Shadcn UI](https://ui.shadcn.com/)

**DevOps & Analytics:**

- [Vercel](https://vercel.com/)
- [GitHub Actions](https://github.com/features/actions)
- [PostHog](https://posthog.com/)

**Scripting & Web Scraping:**

- [Python](https://www.python.org/)
- [BeautifulSoup](https://www.crummy.com/software/BeautifulSoup/bs4/doc/)
- [Pandas](https://pandas.pydata.org/)

**Testing:**

- [Vitest](https://vitest.dev/)

**Design & Planning:**

- [Excalidraw](https://excalidraw.com/)
- [Figma](https://www.figma.com/)

## Contributing

Contributions are highly appreciated! Here's how you can get involved:

### Reporting Bugs & Suggesting Enhancements

If you encounter an issue or have a suggestion for improvement, please create a [GitHub issue](https://github.com/andy-viera/contractorsUy/issues).

### Fixing Issues

1. Find an open issue in the [Issues tab](https://github.com/andy-viera/contractorsUy/issues).
2. Fork the repository and create a feature branch.
3. Submit a pull request with a clear description of your changes.

### Setting Up Locally

#### Prerequisites

- [pnpm](https://pnpm.io/)

```sh
  npm install -g pnpm
  ```

#### Installation

1. Clone the repository:

```sh
   git clone https://github.com/andy-viera/contractorsUy.git
   ```

2. Navigate to the project folder:

```sh
   cd contractorsUy
   ```

3. Install dependencies:

```sh
   pnpm install
   ```

4. Start the development server:
   ```sh
   pnpm run dev
   ```

## Get in Touch

Andrés Viera - contact@aviera.me

contractorsUy

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

contractorsUy

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README