{"id":20385355,"url":"https://github.com/greenheart/lifewheel","last_synced_at":"2025-04-12T09:41:10.869Z","repository":{"id":185328364,"uuid":"606887657","full_name":"Greenheart/lifewheel","owner":"Greenheart","description":"Reflect on Your Life Balance. Local-first, privacy-friendly web app for your personal well-being.","archived":false,"fork":false,"pushed_at":"2025-03-20T15:35:04.000Z","size":1719,"stargazers_count":15,"open_issues_count":13,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-20T16:37:43.226Z","etag":null,"topics":["encryption","humane-tech","local-first","local-first-software","mental-health","privacy","qr-code","svelte","sveltekit","web-crypto"],"latest_commit_sha":null,"homepage":"https://reconnect.earth/lifewheel","language":"Svelte","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Greenheart.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2023-02-26T21:03:02.000Z","updated_at":"2025-03-20T15:35:08.000Z","dependencies_parsed_at":"2024-09-15T23:23:43.770Z","dependency_job_id":"cb08621a-0226-4e73-8e2d-23da717b937c","html_url":"https://github.com/Greenheart/lifewheel","commit_stats":null,"previous_names":["greenheart/lifewheel"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Greenheart%2Flifewheel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Greenheart%2Flifewheel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Greenheart%2Flifewheel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Greenheart%2Flifewheel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Greenheart","download_url":"https://codeload.github.com/Greenheart/lifewheel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248549132,"owners_count":21122831,"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":["encryption","humane-tech","local-first","local-first-software","mental-health","privacy","qr-code","svelte","sveltekit","web-crypto"],"created_at":"2024-11-15T02:33:36.714Z","updated_at":"2025-04-12T09:41:10.852Z","avatar_url":"https://github.com/Greenheart.png","language":"Svelte","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Life Wheel\n\n\u003e [Local-first](https://localfirstweb.dev/), privacy-friendly web app for your personal wellbeing.\n\n\u003cimg src=\"screenshot.png\" width=\"214\" height=\"463\" alt=\"Screenshot of the Lifewheel app. Overview of previous reflections, showing colored circle segments representing eight dimensions of your life.\"\u003e\n\nReflect on your life balance. Visualise your progress over time and reconnect to what matters in your life. Make reflection a habit and gain new insights for your wellbeing.\n\nSeamlessly sync your data across devices with a private link (using the [URI fragment](https://en.wikipedia.org/wiki/URI_fragment) = never sent to the server), QR code, or file. For more security and privacy, let the app generate a passphrase and encrypt your data using the [Web Crypto API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API). Experience how smooth the modern web can be!\n\n[\u003e\u003e DEMO LINK](https://reconnect.earth/lifewheel)\n\n## Project Vision and Key Features\n\n- 🧘 Reflect on your life balance.\n- 🌱 Follow your progress over time and reconnect to what matters in your life.\n- 📊 Make reflection a habit and gain new insights for your wellbeing.\n- 👌 Keep 100% control of your private data.\n- 😇 No signup or account needed. Designed to be used offline.\n  \u003c!-- -   📲 Install the Progressive Web App to reflect on the go. --\u003e\n- 📥 Seamless file exports and imports, giving you full control over data syncing and backups. Integrates well with services like [Nextcloud](https://nextcloud.com/) and [Syncthing](https://syncthing.net/).\n- 🔐 Optionally encrypt your data using the [Web Crypto API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API) to improve your security and privacy. Let the app generate a strong passphrase - or choose your own.\n- 🔗 Save your data as a private link (using the [URI fragment](https://en.wikipedia.org/wiki/URI_fragment) which is never sent to the server). Store your link somewhere safe (for example in your password manager), or save your QR code.\n- ✨ Easily access your data on any device by clicking your private link or by scanning your QR code.\n- ⌨️ Keyboard shortcuts (primarily with the arrow keys) for extra comfort.\n- 🆓 Free as in freedom. This is [free software](https://fsfe.org/freesoftware/), and you're welcome to help make it even better!\n\nDesigned with inspiration from the [Humane Tech](https://www.humanetech.com/) principles, this project explores the possibilities of local-first web apps. Specifically - is it possible to give users full control over their private data, while still providing a smooth user experience? For the answer... well, you have to see it yourself! 😄\n\n**Now check out the [live demo](https://reconnect.earth/lifewheel)!**\n\n---\n\n## Data format: Maintaining backwards compatibility\n\nSince this app only works with local data, backwards compatibility is a key feature. By implementing all export/import logic in versioned protocols, we can let people import their data from old formats, and re-export in the newest format. The goal is to let people just use the app and give an experience that \"just works\".\n\nWhen a new protocol version is added, we only need to keep the import logic from the older versions, since all data will be exported in the new format. If we need the old export-logic for some reason, it's always possible to find it in the git history.\n\n## Start the local development environment\n\nMake sure you have a recent version of [Node.js](https://nodejs.org/en), [pnpm](https://pnpm.io/) and [Git](https://git-scm.com/) installed.\n\n### 1. Install dependencies\n\n```sh\npnpm i\n```\n\n### 2. Start the development server\n\n```sh\npnpm dev\n```\n\nVisit \u003chttp://localhost:5173\u003e to see it and make your changes.\n\n### 3. Workflow for making changes\n\nUse `main` as the base branch, and make sure your local copy is updated.\n\n```sh\ngit switch main\ngit pull\n```\n\nCreate a new branch for your updates:\n\n```sh\n# For new features or larger changes:\ngit switch -c feature/something\n\n# For smaller changes and fixes:\ngit switch -c fix/something\n```\n\nWork on your changes until you are ready. Then it's time to test locally:\n\n#### 3.1. Build a production version for local testing\n\n```sh\npnpm build\n```\n\n#### 3.2. Locally preview the production version\n\n```sh\npnpm preview\n```\n\nWhen you've tested your changes, push the branch to GitHub and open a PR, describing the main changes. If you fixed a specific GitHub-issue, you can reference it in the PR description to automatically close it once the PR is reviewed and merged by using a [special syntax](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword). For example: `Fixes #10`.\n\nAs soon as the change is reviewed and ready, it can be merged and published.\n\nThanks for improving the project! 🌱\n\n## License\n\nAGPL-3.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreenheart%2Flifewheel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreenheart%2Flifewheel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreenheart%2Flifewheel/lists"}