{"id":15111688,"url":"https://github.com/ythiago03/devutils","last_synced_at":"2026-01-20T03:01:28.266Z","repository":{"id":257677216,"uuid":"859002806","full_name":"ythiago03/devutils","owner":"ythiago03","description":"DevUtils is a utility website created for developers, focused on providing practical tools that simplify test data generation and string manipulation. The main goal is to speed up development by offering a platform to quickly generate valid data and perform various string operations, such as conversion and formatting.","archived":false,"fork":false,"pushed_at":"2025-03-06T22:12:24.000Z","size":298,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T17:46:24.438Z","etag":null,"topics":["firebase-firestore","html","in-progress","react","scss","shadcn-ui","tailwind-css","typescript"],"latest_commit_sha":null,"homepage":"https://devutils-th.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ythiago03.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-17T22:55:16.000Z","updated_at":"2025-03-24T21:57:33.000Z","dependencies_parsed_at":"2024-09-18T03:38:36.427Z","dependency_job_id":"b161aeb9-6408-4dbe-9c21-3e583de07661","html_url":"https://github.com/ythiago03/devutils","commit_stats":null,"previous_names":["ythiago03/devutils"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ythiago03/devutils","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ythiago03%2Fdevutils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ythiago03%2Fdevutils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ythiago03%2Fdevutils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ythiago03%2Fdevutils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ythiago03","download_url":"https://codeload.github.com/ythiago03/devutils/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ythiago03%2Fdevutils/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28594958,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T02:08:49.799Z","status":"ssl_error","status_checked_at":"2026-01-20T02:08:44.148Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["firebase-firestore","html","in-progress","react","scss","shadcn-ui","tailwind-css","typescript"],"created_at":"2024-09-26T00:22:24.582Z","updated_at":"2026-01-20T03:01:28.250Z","avatar_url":"https://github.com/ythiago03.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DevUtils\n\n## 1. Descrição Geral\n\nO **DevUtils** é um site de utilidades criado para desenvolvedores, focado em fornecer ferramentas práticas que facilitam a criação de dados de teste e a manipulação de strings. O objetivo principal é agilizar o desenvolvimento, oferecendo uma plataforma para gerar rapidamente dados válidos e realizar diversas operações com strings, como conversão e formatação.\n\n### 1.1 Objetivo\n\nO projeto tem como finalidade fornecer uma série de ferramentas que auxiliam os desenvolvedores em tarefas recorrentes e cotidianas, como:\n\n- Gerar dados de teste válidos (nome, email, telefone, etc.).\n- Manipuladores e conversores de strings.\n- Sites para ícones, APIs, etc.\n- Outras utilidades que facilitam o desenvolvimento de sistemas.\n\n### 1.2 Tecnologias Utilizadas\n\nO projeto foi desenvolvido utilizando as seguintes tecnologias e frameworks:\n\n- **React**: Biblioteca JavaScript para construção da interface do usuário.\n- **TypeScript**: Superconjunto de JavaScript que adiciona tipagem estática ao código.\n- **HTML**: Linguagem de marcação para estruturar o conteúdo da aplicação.\n- **SCSS**: Uma extensão de CSS que oferece recursos adicionais como variáveis e mixins, facilitando o design responsivo.\n- **Vite**: Ferramenta de build rápida para projetos React, utilizada para desenvolvimento e empacotamento.\n- **Jest**: Framework de testes unitários para garantir a funcionalidade e a qualidade do código.\n- **ShadCN**: Design system e biblioteca de componentes para React que segue os princípios de acessibilidade e usabilidade.\n- **Faker**: Biblioteca para gerar dados falsos (mas realistas) para testes e desenvolvimento.\n- **Firebase Firestore**: Firebase Firestore é um banco de dados de documentos NoSQL que permite aos usuários armazenar, sincronizar e consultar dados para seus aplicativos.\n\n### 1.3 Inspirações\n\nEste projeto foi inspirado em sites que fornecem ferramentas semelhantes:\n\n- [Text Mateus F](https://text.mateusf.com)\n- [4Devs](https://www.4devs.com.br)\n- [RandomUser](https://randomuser.me/)\n- [PublicAPIs](https://publicapis.dev/)\n\n## 2. Funcionalidades Principais\n\n### 2.1 Gerador de Dados\n\nPermite a criação de dados aleatórios e válidos para uso em testes de software, como:\n\n- **Nomes completos**\n- **Email**\n- **Endereço**\n\n### 2.2 Manipuladores de String\n\nOferece utilidades para manipulação de strings, como:\n\n- Conversão entre maiúsculas e minúsculas.\n- Remoção de acentos.\n- Substituição de caracteres específicos.\n\n### 2.3 Conversores de String\n\nFerramentas para conversão de formatos de string, como:\n\n- Converte String em Hexadecimal e vice-versa.\n\n## 3. Estrutura do Projeto\n\n### 3.1 Arquitetura\n\nO projeto segue uma arquitetura baseada em componentes, onde cada funcionalidade é encapsulada em um componente React. As rotas são gerenciadas pelo React Router para permitir navegação entre as diferentes utilidades.\n\n### 3.2 Organização dos Arquivos\n\nA estrutura de pastas do projeto está organizada da seguinte forma:\n\n```plaintext\n/devutils\n  ├── /node_modules\n  ├── /public\n  ├── /src\n  │   ├── /components    # Componentes reutilizáveis da aplicação\n  │   ├── /pages         # Páginas principais que representam cada utilidade\n  │   ├── /services      # Lógica de manipulação de dados e APIs\n  │   ├── /styles        # Arquivos SCSS para estilização\n  │   │   ├── _variables.scss  # Variáveis globais de estilo\n  │   │   └── global.scss      # Estilos globais\n  │   ├── /tests         # Testes unitários com Jest\n  │   ├── /utils         # Funções utilitárias para operações de string e dados\n  │   ├── App.tsx        # Componente principal\n  │   ├── main.tsx       # Ponto de entrada da aplicação\n  │   └── setupTests.ts  # Configurações globais de testes\n  ├── jest.config.js     # Configuração do Jest\n  ├── tsconfig.json      # Configuração do TypeScript\n  ├── package.json       # Dependências e scripts do projeto\n  └── vite.config.ts     # Configuração do Vite\n```\n\n## 4. Configuração do Ambiente\n\n### 4.1 Pré-requisitos\n\nCertifique-se de ter o Node.js e o npm instalados em seu ambiente. Caso não tenha, faça o download das versões mais recentes em [nodejs.org](https://nodejs.org).\n\n### 4.2 Passos para Clonar e Executar o Projeto\n\nClone o repositório:\n\n```bash\ngit clone https://github.com/ythiago03/devutils.git\n```\n\nAcesse o diretório do projeto:\n\n```bash\ncd devutils\n```\n\nInstale as dependências:\n\n```bash\nnpm install\n```\n\nInicie o servidor de desenvolvimento:\n\n```bash\nnpm run dev\n```\n\nAbra o navegador e acesse [http://localhost:3000](http://localhost:3000) para visualizar a aplicação.\n\n### 4.3 Scripts Disponíveis\n\n- **npm run dev:** Inicia o servidor de desenvolvimento.\n- **npm run build:** Gera a versão otimizada para produção.\n- **npm test:** Executa os testes unitários com Jest.\n\n## 5. Testes\n\nO projeto está configurado para testes unitários utilizando o Jest e o Testing Library. Para rodar os testes, utilize o comando:\n\n```bash\nnpm run test\n```\n\n## 6. Estilos\n\nO projeto utiliza SCSS para gerenciar os estilos de maneira modular. No diretório src/styles, você pode encontrar os arquivos de estilo principais:\n\n- **global.scss:** Arquivo para os estilos globais da aplicação.\n- **_variables.scss:** Definição de variáveis reutilizáveis (como cores, tamanhos de fonte, etc.).\n\n## 7. Contribuição\n\nContribuições são bem-vindas! Caso queira colaborar com o projeto, siga estas etapas:\n\nFaça um fork do repositório.\nCrie uma branch com sua feature:\n\n```bash\ngit checkout -b minha-feature\n```\n\nFaça o commit das suas alterações:\n\n```bash\ngit commit -m 'Adiciona nova funcionalidade'\n```\n\nEnvie para o repositório remoto:\n\n```bash\ngit push origin minha-feature\n```\n\nAbra um Pull Request para revisão.\n\n## 8. Licença\n\nEste projeto está licenciado sob a licença MIT. Para mais detalhes, consulte o arquivo LICENSE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fythiago03%2Fdevutils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fythiago03%2Fdevutils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fythiago03%2Fdevutils/lists"}