eshimischi/atmosphere

The Digital Home Management Software

^beta

The Digital Home Management Software

Website • Docs • Demo

About Loger

Loger (House in French) as a family managing home is almost like being CEO of a company. There are a lot of things going on that you have to keep in mind. Things like budgeting, expenses, subscriptions to keep healthy financial habits managing goals/savings like an emergency fund or planning your next vacation or Christmas; having a Meal Plan, grocery list generated with the things you need... well, you get the point.

All the things mentioned above are part of our family/personal routine. We do it in our minds or on paper or if you are like me with different software. Loger aims to be a central point to manage all that an more.

✨Features:

Loger is organized in "concerns" by the moment it has 4

• 💵 Finance:

  • Monthly Budget
  • Watchlists
  • Accounts
  • Transactions
  • Statistics/Net Worth
  • Scheduled Transactions*

• 🍗 Meal Planner

  • Recipes
  • Ingredients
  • Meal Planner
  • Random Meal Generator
  • Menus*

• 👨‍👩‍👧 Relationship**

  I don't want to automate/digitalize the humanity of a relationship here but save reminders of activities that would strengthen it like:

  • Goals/Projects like travels and activities

• 🏡Home/Family Projects**

  • Chores
  • Occurrence Checks
  • Plans (Events and activities / Repairs / ETC)
    • Quick Create Budget from plans
    • Quick Create Transactions from plans?
  • Equipment

(*) Feature is planned but not finished yet (**) The section is considered but not planned still in research

Modules

• Plan module: (home/projects)
• Watchlist module: (finance)

Showcase

Demo

View a live demo here, or deploy your instance to DigitalOcean, by clicking the button below.

Dashboard

Meals

Finance Overview

Budget & Goals

Housing

Motivation

• This was an Idea initially considered as a part of a 12x12 SaaS challenge.
• I married and needed something like this to keep my things organized and planned.
• Financial software had fixed categories, and bank sync didn't work in my country or just. worked more like an expense tracker than a budget (Except YNAB).
• 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).

Technical Stuff

Loger is a Monolith app using Laravel 9, jetstream, inertia, vue3, Tailwindcss, and some handcrafted packages Atmosphere UI, Journal, and others.

Prerequisite	Version
Node.js	~ ^20.9.0
npm (comes with Node) or yarn (used)	~ ^5
[PHP]	~ ^8.1.2
Composer	' ^2.3.8
MariaDB***	10.8.4
Cloud Platform Project (with Gmail API)**	--
PHP extension ext-mailparse**	--

** Those requirements are optional for Gmail integration/automation *** MariaDB could be replaced with MySql8

node -v
php -v

Installation

To install Loger, you'll need to clone or download this repo:

git clone https://github.com/jesusantguerrero/atmosphere.git loger

Next, we can install Atmosphere with these 4 simple steps:

1. Copy the .env.example file

We need to specify the 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.

Then, 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.

APP_URL=http://127.0.0.1:8000/

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=loger
DB_USERNAME=root
DB_PASSWORD=

2. Install dependencies

composer install --ignore-platform-reqs;

3. Install loger

yarn app:install"

4. Add sample data(optional)

php artisan app:demo-seed

backend development

php artisan serve

Frontend development The backend has to be running

npm run dev

🎉 And that's it! You will now be able to visit your URL and see your Atmosphere application up and running.

License

BSD-3 license.

Author

Jesus Guerrero

• website: jesusantguerrero.com
• twitter: @jesusntguerrero