TickTask é um aplicativo desktop open source para gerenciamento de tarefas pessoais e profissionais. Desenvolvido com Electron, React e TypeScript, oferece uma interface intuitiva para criar, organizar e rastrear tarefas, com funcionalidade integrada de timer para medir o tempo dedicado a cada atividade.

• Gerenciamento de Tarefas: Crie, edite, exclua e organize suas tarefas
• Timer Integrado: Inicie e pare timers para rastrear tempo gasto em tarefas
• Status de Tarefas: Acompanhe o progresso com badges de status
• Arquivamento: Mova tarefas concluídas para uma seção de arquivadas
• Interface Moderna: UI responsiva e acessível com componentes reutilizáveis
• Banco de Dados Local: Armazenamento persistente usando SQLite
• Notificações: Alertas para lembretes e atualizações

• Frontend: React 18 com TypeScript
• Desktop: Electron
• Build Tool: Vite
• UI Components: Shadcn/UI (baseado em Radix UI)
• Styling: CSS personalizado + Tailwind CSS
• Database: SQLite via better-sqlite3
• Linting: ESLint
• Packaging: Electron Builder

• Node.js (versão 18 ou superior)
• npm ou yarn

git clone https://github.com/seu-usuario/ticktask.git
cd ticktask

npm install

npm run dev

Isso abrirá o aplicativo em modo desenvolvimento com hot reload.

npm run build:linux

Gera:

• dist/ticktask-1.0.0.AppImage - AppImage executável
• dist/ticktask-1.0.0.deb - Pacote Debian

npm run build:win

Gera:

• dist/ticktask-1.0.0-setup.exe - Installer executável

Nota: Para buildar no Windows a partir do Linux, é necessário Wine.

npm run build:mac

Gera:

• dist/ticktask-1.0.0.dmg - Pacote DMG

Os arquivos de build estarão disponíveis na pasta dist/.

Contribuições são bem-vindas! Este é um projeto open source e qualquer ajuda é apreciada. Siga estes passos para contribuir:

Clique no botão "Fork" no GitHub para criar sua própria cópia do repositório.

git clone https://github.com/seu-usuario/ticktask.git
cd ticktask

git checkout -b feature/nome-da-sua-feature

npm install
npm run dev

• Siga as convenções de código existentes
• Adicione testes para novas funcionalidades
• Atualize a documentação se necessário

git add .
git commit -m "feat: adiciona nova funcionalidade"

git push origin feature/nome-da-sua-feature

No GitHub, clique em "New Pull Request" e descreva suas alterações detalhadamente.

• Use commits convencionais (feat, fix, docs, style, refactor, test, chore)
• Mantenha o código limpo e bem documentado
• Adicione testes para novas funcionalidades
• Respeite o código de conduta

ticktask/
├── src/
│   ├── main/           # Processo principal do Electron
│   ├── preload/        # Scripts de preload
│   ├── renderer/       # Interface React
│   │   ├── components/ # Componentes reutilizáveis
│   │   ├── pages/      # Páginas da aplicação
│   │   ├── hooks/      # Hooks customizados
│   │   └── stores/     # Estado global
│   └── shared/         # Tipos e utilitários compartilhados
├── build/              # Configurações de build
├── electron.vite.config.ts
└── package.json

Encontrou um bug? Abra uma issue no GitHub com:

• Descrição clara do problema
• Passos para reproduzir
• Sistema operacional e versão
• Logs de erro (se aplicável)

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

• Electron - Framework para aplicações desktop
• React - Biblioteca para interfaces
• Shadcn/UI - Componentes UI
• Vite - Build tool moderno

Feito com ❤️ por contribuidores open source