it-tools README

The project's README from github.com/CorentinTh/it-tools. As one markdown file: README.md.

logo

Useful tools for developer and people working in IT. Try it!

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:80 corentinth/it-tools:latest

From github packages:

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

Other solutions:

Contribute

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:

  1. 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)
  2. 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!

contributors

Credits

Coded with ❤️ by Corentin Thomasset.

This project is continuously deployed using vercel.com.

Contributor graph is generated using contrib.rocks.

IT Tools - Collection of handy online tools for devs, with great UX | Product Hunt IT Tools - Collection of handy online tools for devs, with great UX | Product Hunt

License

This project is under the GNU GPLv3.

it-tools (CorentinTh/it-tools)

Searching Database…

40.9K ·GitHub
It-tools
Что это такое?It-tools — это бесплатный open-source набор полезных онлайн-инструментов для разработчиков и всех, кто работает в IT: небольшие утилиты с продуманным интерфейсом, собранные в одном веб-приложении.
То есть это сайт, а не программа, которую нужно устанавливать?Это веб-приложение на Vue 3 и TypeScript — вы пользуетесь инструментами прямо в браузере. Единственная необязательная установка — развернуть его у себя в домашней лаборатории через Docker.
Как запустить его у себя?Откройте размещённый сайт или разверните его самостоятельно: готовые образы доступны в Docker Hub и GitHub Packages, есть варианты установки в один клик для Cloudron, Tipi и Unraid. Для локальной разработки npm run dev запускает сервер Vite.
Нужны ли аккаунт, API-ключ или что-то установленное на компьютере?Ни аккаунтов, ни API-ключей — инструменты просто работают в браузере. Для собственного развёртывания нужен только Docker, а для разработки или сборки из исходников — Node.js с npm.
Что стоит знать перед развёртыванием или сборкой?Поводов для беспокойства мало: вместо самостоятельной компиляции можно взять готовые образы. Если вы всё же собираете production-сборку, скрипт сборки увеличивает лимит памяти Node до 4 ГБ.
Инструменты работают прямо в моём браузере или мои данные куда-то уходят?Это статический Vue-фронтенд без бэкенда, который непрерывно развёрнут на Vercel — инструменты выполняются на стороне клиента, в вашем браузере.
Это правда бесплатно, и что разрешает лицензия?Полностью бесплатно и с открытым исходным кодом под GNU GPLv3. Это copyleft-лицензия, поэтому изменённая версия, которую вы распространяете, тоже должна оставаться под GPLv3.
Какие инструменты там есть?Широкий набор небольших утилит для разработчиков, разложенный по категориям внутри приложения. В README они не перечислены; список готового и запланированного ведётся в GitHub issues, там же можно попросить добавить новый инструмент.
Как добавить в набор свой инструмент?Запустите скрипт-генератор заготовок: он создаёт каталог внутри src/tools со всеми нужными файлами и добавляет импорт в src/tools/index.ts. Затем зарегистрируйте инструмент в подходящей категории и напишите его реализацию.
Проект активно поддерживается?Да — это активный проект с 40k+ звёзд на GitHub, CI-конвейерами для релизов, ночными Docker-образами и e2e-тестами; размещённая версия непрерывно обновляется через Vercel.
What are similar projects?omni-tools, gin-vue-admin, vuestic-admin, vue-admin-better, hoppscotch, chatgpt-web, dockge, convert
Which topics is it in?developer-productivity, converter, website, tools, vuejs, vue3, homelab, vercel, vite, vue, gplv3, web-app
Creator
CorentinTh
Size
13.4 MB
Stars
40.9K
Updated
CommitFeb 12Releasev2024.10.22-7ca5933Oct 22
Age
6y
Commits · 90 Days