{"id":14155341,"url":"https://github.com/jesusantguerrero/atmosphere","last_synced_at":"2025-09-13T10:52:46.447Z","repository":{"id":37791002,"uuid":"345000760","full_name":"jesusantguerrero/atmosphere","owner":"jesusantguerrero","description":"The Digital Home Management Software","archived":false,"fork":false,"pushed_at":"2025-02-09T14:25:44.000Z","size":22390,"stargazers_count":30,"open_issues_count":10,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-09T15:28:40.653Z","etag":null,"topics":["budget","chores","finance","inertiajs","jetstream-laravel","jetstream-with-inertia","laravel","meal-planner","personal-finance","php","tailwindcss","vue3"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jesusantguerrero.png","metadata":{"files":{"readme":"README-es-ES.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":"2021-03-06T04:01:21.000Z","updated_at":"2025-02-09T14:25:48.000Z","dependencies_parsed_at":"2023-12-22T21:23:36.074Z","dependency_job_id":"63f3ae8e-d7b9-4123-9004-f40da91a0bcb","html_url":"https://github.com/jesusantguerrero/atmosphere","commit_stats":null,"previous_names":[],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jesusantguerrero%2Fatmosphere","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jesusantguerrero%2Fatmosphere/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jesusantguerrero%2Fatmosphere/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jesusantguerrero%2Fatmosphere/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jesusantguerrero","download_url":"https://codeload.github.com/jesusantguerrero/atmosphere/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248831636,"owners_count":21168521,"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":["budget","chores","finance","inertiajs","jetstream-laravel","jetstream-with-inertia","laravel","meal-planner","personal-finance","php","tailwindcss","vue3"],"created_at":"2024-08-17T08:02:53.121Z","updated_at":"2025-04-14T06:25:09.799Z","avatar_url":"https://github.com/jesusantguerrero.png","language":"Vue","funding_links":[],"categories":["tailwindcss"],"sub_categories":[],"readme":"# Loger 🏡\n\n\u003ch3 align=\"center\"\u003e\n    The Digital Home Management System (El Sistema de Manejo de Hogar Digital)\n\u003c/h3\u003e\n\n\u003c!-- \u003cp align=\"center\"\u003e\n\t\u003cstrong\u003e\n\t\t\u003ca href=\"https://loger.neatlancer.com/\"\u003eWebsite\u003c/a\u003e\n\t\t•\n\t\t\u003ca href=\"https://loger.neatlancer.com\"\u003eDocs\u003c/a\u003e\n\t\t•\n\t\t\u003ca href=\"https://loger.neatlancer.com\"\u003eDemo\u003c/a\u003e\n\t\u003c/strong\u003e\n\u003c/p\u003e --\u003e\n\u003e Status: Alpha\n\n\u003e Codename: Atmosphere\n## Acerca de Loger\n\nAdministrar una familia es casi como ser presidente de una empresa. \nHay un monton de cosas que hay que tener en cuenta y llevar pendiente.\nCosas como: **Presupuesto**, **gastos**, **subscripciones** para mantener buenos habitos financieros.\nAdemas de manejar las metas/ahorros como **fondo de emergencia** o planificar tus proximas vacaciones;\n\nUna gran parte del presupuesto de un individuo/familia va a la comida, pero tambien la comida es esencial,\npara llevar una vida saludable. Tener un **Planificador de Comida**, que ademas auto-genere una lista de compras con las cosas que necesitas puede ser de gran ayuda y si podriamos seguir... bueno, creo que ya entiendes por donde voy.\n\nTodas las cosas mencionadas arriba son parte de nuestra rutina familiar/personal. \nLo hacemos todo el tiempo en nuestra mente o en papel o (si eres como yo) usando diferentes aplicaciones. Loger busca centralizar todo ese sistema en una sola aplicacion.\n\n## ✨Caracteristicas:\n\nLoger is está organizado en 4 \"aspectos/secciones\" por el momento\n\n* ### 💵 Finance:\n    - [x] Presupuesto Mensual\n    - [x] Categorias / Grupos\n    - [x] Alertas de gastos\n    - [x] Cuentas\n    - [x] Transacciones\n    - [x] Metricas/Net Worth\n    - [ ] Transacciones periodicas\n\n* ### 🍗 Comidas\n    - [x] Recetas   \n    - [x] Ingredientes\n    - [x] Planificador de comidas\n    - [x] Generador de comida al azar\n    - [ ] Menus*\n\n* ### 👨‍👩‍👧 Relacion/Pareja**\n    No quiero automatizar/digitalizar el factor humano de una relacion. Esta seccion solo seria para organizar notas, actividades, planes enfocados en la relacion mas que en la familia cosas como`:\n\n    - Metas, Proyectos, viajes y actividades.\n\n* ### 🏡Home/Family Projects**\n    En mi corta experiencia como padre/co-cabeza de familia he notado que hay cosas que necesitan accione pero no inmediata,\n    quiza solo necesitamos un reminder para ponerlo en presupuesto el mes siguiente o en tres meses.\n\n    - Nuevos muebles\n    - Reparaciones de la casa/Mejoras\n    - Eventos y actividades familiares\n\n\n\u003e  (*) Caracteristica planificada pero no terminada\n(**) Seccion esta considerada, pero no planificada aun estoy haciendo mis investigaciones.\n\n\u003c!-- ## Demo\n\n\u003ca href=\"https://cloud.digitalocean.com/apps/new?repo=https://github.com/jesusantguerrero/atmosphere/tree/staging\" target=\"_blank\"\u003e\u003cimg src=\"https://www.deploytodo.com/do-btn-blue.svg\" width=\"240\" alt=\"Deploy to DO\"\u003e\u003c/a\u003e --\u003e\n\n## Showcase\n\nDashboard Expanded \n![Dashboard](/public/images/full-sized-dashboard.png)\n\nDashboard\n![Dashboard](/public/images/dashboard-small-menu.png)\n\nMeal Planner\n![Meal Planner](/public/images/meal-planner.png)\n\nFinance Overview\n![Finance Overview](/public/images/finance-overview.png)\n\nBudget\n![Budget](/public/images/budget.png)\n\n## Motivation\n- This was an Idea initially considered as a part of a 12x12 SaaS challenge.\n- I married and needed something like this to keep my things organized and planned.\n- Financial software had fixed categories, bank sync didn't work in my country or just. worked more like expense tracker than budget (Except YNAB).\n- I didn't want to have multiple apps to manage things of the same context and need a relation (Budgeting app, calendars, meal planner, custom notion template).\n\n\n## Technical Stuff\nLoger is a Monolith app using laravel 9, jetstream, inertia, vue3, Tailwindcss and some hand crafted packages [Atmosphere UI](https://github.com/jesusantguerrero/atmosphere-ui), [Journal](https://github.com/insane-code/journal), and others.\n\n\n| Prerequisite                                          | Version     |\n| ------------------------------------------------------| ----------  |\n| [Node.js](http://nodejs.org)                          | `~ ^14.18.0`|\n| npm (comes with Node) or yarn (used)                  | `~ ^5`      |\n| [PHP]                                                 | `~ ^8.1.2`  |\n| [Composer](https://getcomposer.org/)                  | ' ^2.3.8    |\n| [MariaDB](https://mariadb.org/)***                    |  `10.8.4`   |\n| [Cloud Platform Project (with Gmail API)**](https://developers.google.com/gmail/api/quickstart/js)                                |    --                                                 |             |\n| PHP extension ext-mailparse**                         |      --     |\n\n`** Those requirements are optional for Gmail integration/automation`\n`*** MariaDB could be replaced with MySql8`\n\n```shell\nnode -v\nphp -v\n```\n\n## Installation\n\nTo install Loger, you'll need to clone or download this repo:\n\n```\ngit clone https://github.com/jesusantguerrero/atmosphere.git project_name\n```\n\nNext, we can install Atmosphere with these **4 simple steps**:\n\n### 1. Create a New Database\n\nDuring the installation we need to use a MySQL database. You will need to create a new database and save the credentials for the next step.\n\n### 2. Copy the `.env.example` file\n\nWe need to specify our Environment variables for our application. You will see a file named `.env.example`, you will need to duplicate that file and rename it to `.env`.\n\nThen, open up the `.env` file and update your *DB_DATABASE*, *DB_USERNAME*, and *DB_PASSWORD* in the appropriate fields. You will also want to update the *APP_URL* to the URL of your application.\n\n```bash\nAPP_URL=http://127.0.0.1:8000/\n\nDB_CONNECTION=mysql\nDB_HOST=127.0.0.1\nDB_PORT=3306\nDB_DATABASE=loger\nDB_USERNAME=root\nDB_PASSWORD=\n```\n\n### 3. Add Composer Dependencies\n```php\ncomposer install --ignore-platform-reqs\n```\n### 4. Run Migrations and Seeds\n\n```bash\nphp artisan migrate\nphp artisan db:seed\nphp artisan journal:set-accounts\n```\n\u003cbr\u003e\n\nbackend development\n```bash\nphp artisan serve\n```\nFrontend development\nThe bachend have to be running\n\n```bash\n# install npm packages\nnpm install\n# development\nnpm run dev\n```\n\n🎉 And that's it! You will now be able to visit your URL and see your Atmosphere application up and running.\n\n## License\n[BSD-3 license](https://github.com/jesusantguerrero/atmosphere/blob/master/LICENSE).\n\n## Author\nJesus Guerrero\n- website: [jesusantguerrero.com](https://jesusantguerrero.com)\n- twitter: [@jesusntguerrero](https://twitter.com/jesusntguerrero) \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjesusantguerrero%2Fatmosphere","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjesusantguerrero%2Fatmosphere","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjesusantguerrero%2Fatmosphere/lists"}