Skip to content

Commit

Permalink
Basic readme
Browse files Browse the repository at this point in the history
  • Loading branch information
awallenfang committed Aug 6, 2024
1 parent 17108d4 commit e3a9f8a
Showing 1 changed file with 45 additions and 0 deletions.
45 changes: 45 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Household Planner

The household planner is a web application built for planning todos and similar for shared living spaces, specifically. Although it can also be used for single households.

## Setup

First setup a Python venv:
```
# Set up venv
python -m venv env
# Activate venv
# Linux/Mac
source ./env/bin/activate
# Windows
.\env\bin\activate.bat
# or
.\env\bin\activate.ps1
```

Running this requires a few dependencies. These can be installed as follows:
```
# Installing requirements
python -m pip install -r requirements.txt
```

Before the first execution the database has to be set up:
```sh
# Build migrations for the current app
python manage.py makemigrations

# Run the migrations
python manage.py migrate
```

Afterwards the application can be run using the following:
```sh
python manage.py runserver <port>
```

## Access to the admin panel

A superuser to access the admin panel can be created as follows:
```sh
python manage.py createsuperuser
```

0 comments on commit e3a9f8a

Please sign in to comment.