Skip to content

jesusantguerrero/atmosphere

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Loger logo beta

The Digital Home Management Software

WebsiteDocsDemo

example workflow

image

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.

Deploy to DO

Dashboard

Dashboard

Meals

Meals Section

Finance Overview

Finance Overview

Budget & Goals

Budget & Goals

Housing

image

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