deepFocus
building the "oura" for work
DeepFocus
Building the Oura for productivity. Get insights on how productive you are.
Primarily for macOS. Coming to Windows & Linux shortly.
Table of Contents
Features
- Daily email summaries of deep work hours
- Productivity tracking and insights
- Customizable productivity site labeling
Tech Stack
Getting Started
Prerequisites
- Node.js LTS >=v20.12.2
- npm v10.5.0
Installation
npm install
npm run dev
Usage
Note, for running this app locally, you may run into issues with active-window. Try running npm install --ignore-scripts to fix this. More info here.
Goals
- Allow all users to download on any machine through an Electron JS app
- Migrate to TypeScript and implement SolidJS
- Set up CI/CD pipeline and automatic releases
- Implement changelog using conventional commits
- Add integration and automated tests
- Implement user authentication and cloud-based data persistence
- Implement progress bar for deep work visualization
- Improve user onboarding experience
- Use inspiration from debugtron to render the electron apps most commonly used. Use another API service to get the favicons of the top websites and include this in email and in the desktop app.
- Implement a basic email notification system
- Sign & Notarize the app for macOS
- Allow users to enter session goals and customize productive/unproductive sites
- Migrate from electron-storage to SQLite for improved data handling
- Enhance data analysis and insights
- Develop comprehensive test suite for main and renderer processes
- Create cloud synchronization for user data and preferences
- Implement secure user authentication system
- Collect each site visited. Show users all sites visited in the past day at the end of the day/next day and ask them to label them as productive or unproductive.
- To do list like functionality? Have people add tasks to their list and mark as productive or not productive. Then, at the end of the day, they can see a list of tasks and see how productive they were.
- [] Add toast components.
Philosophy
DeepFocus is built primarily for Software Engineers, Product Managers, and Designers. We believe in:
- Creating systems to combat imposter syndrome
- Focusing on the journey, not just the end goal
- Encouraging consistent, focused work
Roadmap
- Implement progress bar for deep work visualization
- Enhance data analysis and insights
- Improve user onboarding experience
- Develop comprehensive test suite for main and renderer processes
- Create cloud synchronization for user data and preferences
- Implement secure user authentication system
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contact
Timeo Williams @timeowilliams - [email protected]
Troubleshooting
- Manually Open the Application
When macOS shows the “developer cannot be verified” error, you can bypass this warning by manually opening the app.
Right-click on the Deep Focus app in the Applications folder. Select Open. You should see the same warning message, but this time there will be an Open button to proceed with opening the app. This will whitelist the app for future use.
-
pnpm (not supported) We saw some issues with how pnpm was bundling dependencies in the electron-builder stage and it's inability to target certain architectures. We recommend using npm for now.
-
Verifying the app:
codesign -vvv --deep --strict "${appPath}"
# Check the code signing status of a binary
codesign -vvv --strict --verbose "${binary}"
# Check the notarization status of app
spctl -a -v --type install "${dmgPath}"
# Notarize the .dmg after its signed
xcrun notarytool log "UUID" --apple-id "my apple ID" --team-id "my team id" --password "my app password"
# Check contents of provision profile
security cms -D -i "/Users/{yourname}/Library/Developer/Xcode/UserData/Provisioning\ Profiles/{nameOfProvisioningProfile}.provisionprofile"
# Check stapler process
xcrun stapler staple dist/mac-arm64/Deep\ Focus.app
- Find logs:
on macOS: ~/Library/Logs/{app name}/main.log
