{"id":15377643,"url":"https://github.com/rstacruz/flowloop-2018","last_synced_at":"2025-06-13T02:36:21.917Z","repository":{"id":66010160,"uuid":"84805271","full_name":"rstacruz/flowloop-2018","owner":"rstacruz","description":"A Pomodoro-like timer for hyper-productivity","archived":false,"fork":false,"pushed_at":"2018-02-13T21:13:47.000Z","size":2644,"stargazers_count":72,"open_issues_count":1,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-14T23:56:24.631Z","etag":null,"topics":["pomodoro","progressive-web-app","react","redux","timer"],"latest_commit_sha":null,"homepage":"https://ricostacruz.com/flowloop","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rstacruz.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}},"created_at":"2017-03-13T09:04:10.000Z","updated_at":"2024-08-25T13:49:35.000Z","dependencies_parsed_at":"2023-05-22T11:00:27.690Z","dependency_job_id":null,"html_url":"https://github.com/rstacruz/flowloop-2018","commit_stats":null,"previous_names":["rstacruz/flowloop-2018"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstacruz%2Fflowloop-2018","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstacruz%2Fflowloop-2018/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstacruz%2Fflowloop-2018/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstacruz%2Fflowloop-2018/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rstacruz","download_url":"https://codeload.github.com/rstacruz/flowloop-2018/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249116491,"owners_count":21215195,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["pomodoro","progressive-web-app","react","redux","timer"],"created_at":"2024-10-01T14:12:59.268Z","updated_at":"2025-04-15T17:22:26.023Z","avatar_url":"https://github.com/rstacruz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align='center'\u003e\u003cbr\u003e\u003cbr\u003e\u003cimg src='https://cdn.rawgit.com/rstacruz/flowloop/v0.3.0/web/assets/flowloop-logo.svg' alt='Flowloop'\u003e\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\u003c/h1\u003e\n\n\u003e A Pomodoro-like timer for hyper-productivity\n\n[![Status](https://travis-ci.org/rstacruz/flowloop.svg?branch=master)](https://travis-ci.org/rstacruz/flowloop \"See test builds\")\n\n\n\u003cp align='center'\u003e\u003ca href='http://ricostacruz.com/flowloop/'\u003e\u003cimg src='docs/images/screenshot.png' width='400'\u003e\u003c/a\u003e\u003c/p\u003e\n\n\n## About\n\nFlowloop is a productivity timer that helps you maintain a [state of flow](https://en.wikipedia.org/wiki/Flow_(psychology)). It keeps you aware of time without having to interrupt you.\n\nWhen using Flowloop, your day will be divided into **laps**. Each lap represents 25 minutes of productive work. This lets you:\n\n- __Schedule work better.__ You'll be able to do around 10 laps in one typical work day. Awareness of laps will help you schedule your time wisely.\n\n- __Motivate yourself.__ By keeping a list of laps over the last week, you'll be giving yourself a subtle push of encouragement to perform as much as yesterday, if not better.\n\n- __Manage distractions.__ By clearly designating time periods as for work and break, it helps you be more productive in your work and enjoy your breaks better.\n\n## How it works\n\n- Every 25 minutes of uninterrupted work time is **1 lap**. A bell sound will be played when you finish a lap.\n\n- The next lap will sound 1 more bell than the last, as long as your work is not interrupted. That is: 1 bell for the first lap, 2 bells for the second, and so on. This keeps you aware of how long you've been working.\n\n- You can take a break any time you wish for as long as you want. Increasing number of bells will also play every 5 minutes to remind you to get back to work.\n\n- Flowloop will keep a list of all your completed laps every day. This lets you see how productive you've been throughout the day and week.\n\n## Comparison with Pomodoro\n\nFlowloop was born out of the frustration of Pomodoro timers all imposing 5-minute distraction breaks just as you're starting to get focused. I prefer a timer that gently reminds me of time spent, rather than one that requires my input 4 times in an hour.\n\nFlowloop is Pomodoro with no limits on work hours or break lengths. You'll be subtly reminded of how long you've been working (or on break), instead of being forced to stop or to start.\n\n\u003cbr\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eSet up instructions\u003c/summary\u003e\n\n## Set up\n\nRequires Node 6+ and Yarn.\n\n```sh\nyarn            # First-time setup\nyarn start      # Development server\n```\n\n```sh\nyarn run build  # Build for production (builds into /public)\n```\n\n## What's here\n\n| Path | Purpose\n| --- | ---\n| `/web/assets` | the files to be copied into `/public/assets`\n| `/web/html` | the files to be copied into `/public`\n| `/web/css` | CSS files (via PostCSS)\n| `/web/js` | JS files (via Browserify)\n| `/public` | The built files (gitignored)\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eSources\u003c/summary\u003e\n\n## Sources\n\n- \u003chttps://notificationsounds.com/standard-ringtones/echoed-ding-459\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eElectron mode\u003c/summary\u003e\n\n## Electron mode\n\nExperimental - run it in Electron via:\n\n```sh\n# In separate terminals\nyarn run electron:watch\nyarn run electron:start\n```\n\nAnd package it via:\n\n```sh\nyarn run electron:dist\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eDeveloper tools\u003c/summary\u003e\n\n## Developer tools\n\nThe app is exposed via `window.__APP__` for debugging.\n\n```js\n// Shorten work duration to 4 seconds\n__APP__.store.dispatch({ type: 'settings:update', payload: { 'duration:work': 4000 } })\n\n// Reset to defaults\n__APP__.store.dispatch({ type: 'settings:reset' })\n\n// Clear log items\n__APP__.store.dispatch({ type: 'log:clear' })\n\n// Test sound\n__APP__.store.dispatch({ type: 'notifier:testSound!', count: 3 })\n\n// Obliterate local data\ndelete localStorage.TimerData\n\n// Copy local data for exporting to clipboard\nprompt('', localStorage.TimerData)\n\n// Turn on debugging\nwindow.localStorage.debug = 'app:*'\n```\n\u003c/details\u003e\n\n\u003cbr\u003e\n\n## Thanks\n\n**flowloop** © 2017, Rico Sta. Cruz. Released under the [MIT] License.\u003cbr\u003e\nAuthored and maintained by Rico Sta. Cruz with help from contributors ([list][contributors]).\n\n\u003e [ricostacruz.com](http://ricostacruz.com) \u0026nbsp;\u0026middot;\u0026nbsp;\n\u003e GitHub [@rstacruz](https://github.com/rstacruz) \u0026nbsp;\u0026middot;\u0026nbsp;\n\u003e Twitter [@rstacruz](https://twitter.com/rstacruz)\n\n[![](https://img.shields.io/github/followers/rstacruz.svg?style=social\u0026label=@rstacruz)](https://github.com/rstacruz) \u0026nbsp;\n[![](https://img.shields.io/twitter/follow/rstacruz.svg?style=social\u0026label=@rstacruz)](https://twitter.com/rstacruz)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frstacruz%2Fflowloop-2018","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frstacruz%2Fflowloop-2018","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frstacruz%2Fflowloop-2018/lists"}