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 是一个免费开源的合集,收录了面向开发者和 IT 从业者的各种实用在线小工具——都是体验很好的小型实用程序,集中在一个网页应用里。
所以它是个网站,不是需要安装的软件?它是一个用 Vue 3 和 TypeScript 构建的网页应用——直接在浏览器里使用这些工具。唯一可选的安装方式是通过 Docker 把它自部署到自己的家庭服务器上。
我怎么把它跑起来自己用?打开在线版网站,或者自己部署:现成的镜像来自 Docker Hub 或 GitHub Packages,Cloudron、Tipi 和 Unraid 都支持一键安装。本地开发的话,运行 npm run dev 即可启动 Vite 服务器。
使用它需要注册账号、API 密钥或安装什么吗?不需要账号或 API 密钥——工具直接在浏览器里运行。自部署只需要 Docker;如果要开发或从源码构建,则需要安装 Node.js 和 npm。
自部署或自己构建之前,有什么需要知道的吗?几乎没什么可担心的:你可以直接运行现成的镜像,不必自己编译。如果你确实要构建生产版本,构建脚本会把 Node 的内存上限提高到 4 GB。
这些工具是在我的浏览器里运行的吗?我的数据会发出去吗?它是一个纯静态的 Vue 前端,技术栈里没有后端,通过 Vercel 持续部署——所有工具都在你的浏览器端本地运行。
它真的免费吗?许可证允许做什么?完全免费开源,采用 GNU GPLv3 许可证。这是一个 copyleft(著佐权)许可证,所以你分发修改后的版本时,也必须继续采用 GPLv3。
里面都有哪些类型的工具?包含一大批开发者小工具,在应用里按类别整理。README 并没有逐一列出;已有功能和规划中的功能路线图记录在 GitHub issues 里,你也可以在那里申请新增工具。
我怎么把自己的工具加进这个合集?运行脚手架生成脚本:它会在 src/tools 下创建一个目录,包含所需的文件,并在 src/tools/index.ts 里添加导入。然后在对应的类别中注册这个工具并实现它。
这个项目还在积极维护吗?是的——这是一个活跃的项目,在 GitHub 上有 4 万多个 star,配有用于发布、每夜构建 Docker 镜像和端到端测试的 CI 流水线;在线版部署也通过 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