Skip to content

README.md

Latest commit

 

History

History
50 lines (35 loc) · 1.68 KB

README.md

File metadata and controls

50 lines (35 loc) · 1.68 KB

TaskForge

A simple, community-maintained open-source task tracker. Add tasks, check them off, never lose them — everything is stored in your browser.

Status: Active development. We accept bounties via CodeBounty on tagged issues.

Features

  • Single-page, zero-build web app
  • Tasks persist in localStorage by default, with optional GitHub sign-in sync
  • GitHub OAuth uses PKCE in the browser and an HTTP-only session cookie
  • Keyboard-friendly (more shortcuts coming, see #5)
  • Light & dark themes (dark coming, see #1)
  • MIT licensed

Quick start

git clone https://github.com/CodeBountyOrg/taskforge-demo.git
cd taskforge-demo
npm start
open http://localhost:8000

GitHub sign-in is enabled when GITHUB_CLIENT_ID is set. If your OAuth app requires it, set GITHUB_CLIENT_SECRET on the server too; the secret is only used by the backend token exchange endpoint.

Contributing

We welcome contributions! See CONTRIBUTING.md — TL;DR:

  1. Pick an open issue with the 💰 Bounty Available label.
  2. Apply on the bounty's CodeBounty page (linked in the issue).
  3. Once accepted, fork → branch → PR. Reference the issue number in the PR body (Closes #N).
  4. After merge, your payout is released via Stripe.

Maintainers approve bounties before they open and review all PRs before merge.

Tech

  • HTML5, CSS3 (custom properties + flexbox)
  • Vanilla JavaScript (ES2020+); no framework, no build step
  • Built-in Node.js server for static assets, GitHub OAuth, sessions, and task sync
  • localStorage fallback for unsigned users and offline edits
  • ESLint + Prettier for code style

License

MIT — see LICENSE.