Descent098 / TECHSTART

Repo for Tech Start centralized web app project

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

TECHSTART

Below is everything you need to get started running the TECHSTART app.

Table of contents

Running Locally

Installing python

You will first need to install python 3 and pip. If you have done this successfully then on windows you should be able to run:

Windows python --version and pip --version
MacOS/Linux python3 --version and pip3 --version

You should see Python 3.9.0 (number may be different but anything 3.8+ is fine) and pip 21.0.1 from c:\users\kieran\appdata\local\programs\python\python39\lib\site-packages\pip (python 3.9) (Just make sure the python version number in brackets matches the number from above) respectively

Installing Django

If you have never used Django I would highly recommend looking into either the official tutorial, or the Mozilla Tutorial, or the [video crash course]((2) Python Django Crash Course - YouTube).

To install Django run:

Windows pip install django
MacOS/Linux pip3 install django or sudo pip3 install django

To make sure it's installed properly run django-admin help and you should see:

Type 'django-admin help <subcommand>' for help on a specific subcommand.

Available subcommands:

[django]
    check
    compilemessages
    ... # list continues

Running TECHSTART

To run the project simply run python manage.py runserver and you can naviagte to http://localhost:8000 to see the server.

Contributor documentation

Folder/File explanation

At the top level there are a few files README.md (what you're reading), manage.py and .gitignore. manage.py does not need to be touched, it is the file that runs when you start the app, and is setup by default from Django. .gitignore is used to ignore files that we don't need in the git repo (caches of files etc.). Along with that there is a folder called Planning which contains all planning documents.

The rest of the folders are the actual code. Django itself is structured into an app/project distinction, so I will tailor the rest of the documentation around that.

Project

everything inside /techstart is the "project". Amoung other things this contains:

  • The list of installed apps
  • The global URL list
  • The settings that are global across all apps
  • Boilerplate file for running the server (wsgi and asgi)

You can think of this folder as mainly the server configuration, and each app as more of a particular peice of functionality.

Apps

Each app is essentially a particular peice of functionality that includes:

  • The backend code (the models that drive the views that render the frontend templates)
  • The frontend templates associated with the functionality
  • Any additional URL routing changes that need to be made or URL patterns that need to be defined

There are a few apps inside the project, and they are detailed below.

Users

This app contains the models, views and templates associated with getting the user logged in, and accessing their data. One thing to note here is that the current homepage for the site exists here (in /users/templates/index.html)

Integrations

This app contains all the models, views and templates associated with various integrations (discord, snapchat etc.).

About

Repo for Tech Start centralized web app project


Languages

Language:Python 55.7%Language:HTML 30.4%Language:CSS 10.8%Language:JavaScript 3.1%