sharevb/it-tools

•Updated 7 days ago

My additions (and of others) to it-tools! (Collection of handy online tools for developers)

Image

1M+

sharevb/it-tools repository overview

⁠BREAKING CHANGE for Docker Image

Since Docker base image is now nginx-unpriviledged, docker image now listen to 8080 and no more 80. So you need to update your port mapping, ie from 8080:80 to 8080:8080.

⁠Check out these change here: https://sharevb-it-tools.vercel.app/⁠

You can use my image in your docker-compose file if you want an update to date version of it-tools (with my PR and some of others) until the main branch has been updated.

github action triggers on every push to this branch - view package here⁠

(Thanks to gitmotion⁠ for this model of README fork)

⁠Added features

Almost all tools PR of it-tools⁠.

⁠Build docker image for a subfolder

According to https://github.com/sharevb/it-tools/pull/461#issuecomment-1602506049⁠:

docker build -t it-tools --build-arg BASE_URL="/my-folder/" .
docker run -d --name it-tools --restart unless-stopped -p 8080:8080 it-tools

⁠Use in Docker Compose file

services:
  it-tools:
    container_name: it-tools
    image: ghcr.io/sharevb/it-tools:nightly
    pull_policy: always
    restart: unless-stopped
    ports:
      - 8080:8080

⁠Installation methods

Local installation required installing first: python3 make g++

Docker Image	Local Installation
`ghcr.io/sharevb/it-tools:latest`	`sudo apt-get install python3 make g++ && git clone -b chore/all-my-stuffs https://github.com/sharevb/it-tools.git && cd it-tools/ && pnpm i && pnpm dev`
replace your current image with this image	copy & paste oneliner (from github repo)
You may need to clear cache and hard reload to get new features loading	Installing packages for the first time may take some time; please wait until it finishes

Useful tools for developer and people working in IT. Have a look !⁠.

⁠Functionalities and roadmap

Please check the issues⁠ to see if some feature listed to be implemented.

You have an idea of a tool? Submit a feature request⁠!

⁠Self host

Self host solutions for your homelab

From docker hub:

docker run -d --name it-tools --restart unless-stopped -p 8080:8080 corentinth/it-tools:latest

From github packages:

docker run -d --name it-tools --restart unless-stopped -p 8080:8080 ghcr.io/corentinth/it-tools:latest

Other solutions:

⁠Contribute

⁠Recommended IDE Setup

VSCode⁠ with the following extensions:

with the following settings:

{
  "editor.formatOnSave": false,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  },
  "i18n-ally.localesPaths": ["locales", "src/tools/*/locales"],
  "i18n-ally.keystyle": "nested"
}

⁠Type Support for `.vue` Imports in TS

TypeScript cannot handle type information for .vue imports by default, so we replace the tsc CLI with vue-tsc for type checking. In editors, we need TypeScript Vue Plugin (Volar)⁠ to make the TypeScript language service aware of .vue types.

If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a Take Over Mode⁠ that is more performant. You can enable it by the following steps:

Disable the built-in TypeScript Extension
1. Run Extensions: Show Built-in Extensions from VSCode's command palette
2. Find TypeScript and JavaScript Language Features, right click and select Disable (Workspace)
Reload the VSCode window by running Developer: Reload Window from the command palette.

⁠Project Setup

pnpm install

⁠Compile and Hot-Reload for Development

pnpm dev

⁠Type-Check, Compile and Minify for Production

pnpm build

⁠Run Unit Tests with Vitest⁠

pnpm test

⁠Lint with ESLint⁠

pnpm lint

⁠Create a new tool

To create a new tool, there is a script that generate the boilerplate of the new tool, simply run:

pnpm run script:create:tool my-tool-name

It will create a directory in src/tools with the correct files, and a the import in src/tools/index.ts. You will just need to add the imported tool in the proper category and develop the tool.

⁠Contributors

Big thanks to all the people who have already contributed!

⁠Credits

Coded with ❤️ by Corentin Thomasset⁠.

This project is continuously deployed using vercel.com⁠.

Contributor graph is generated using contrib.rocks⁠.

⁠License

This project is under the GNU GPLv3⁠.

Tag summary

Recent tags

Content type