Coder Social home page Coder Social logo

jesusantguerrero / atmosphere Goto Github PK

View Code? Open in Web Editor NEW
22.0 5.0 1.0 18.8 MB

The Digital Home Management Software

License: BSD 3-Clause "New" or "Revised" License

PHP 40.77% Vue 52.53% Blade 0.15% Dockerfile 0.07% TypeScript 6.21% JavaScript 0.26% Batchfile 0.01%
laravel php vue3 inertiajs tailwindcss budget finance meal-planner personal-finance chores

atmosphere's Introduction

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

atmosphere's People

Contributors

jesusantguerrero avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

Forkers

eshimischi

atmosphere's Issues

Beta 1

General:

Finance:

  • #113
  • #112
  • #114
  • #115
  • Fetch non-automatic transactions close to a date as templates in transaction modal
  • #127
  • WatchList by label, payee or categories

Meals

  • Add meal rules:
    Events: After Like
    Actions: Add to planner
  • Allow recipe of different type in planner but with alert
  • Allow remove and replace meals from planner
  • #130

Alpha Version of Loger

The Plan

The basic idea of Loger (House in French) is to provide a tool to plan, organize, and measure the foundation of house management.

  • Finance / Budget / FinancialGoals
  • Meal / Meal Plan / Grocery List / Random Plate
  • Relationships things** (optional) / Movies List, Places , Important Events? xD

But for the first milestone, I think Finance and Meal planner could be the heart of the system.

Tasks

If something more interesting comes lets doit for the beta once those things are good to go

Alpha 2

The Plan

After defining the basic Idea and implementing the core this software have to be usable for other users and not only by myself.
Let's make it more intuitive for external users

General

Finance

MealPlanner

Alpha 4

Final round: System must be functional in all basic aspects. finish Meal Planner setup, add trends for finance, and review any minor bugs.

Finance

Meal Planner

Import

Add meal categories

Add Meal Types model to support custom [breackfast, lunch, snacks, dinner]

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.