Skip to content

A mobile app to teach new programmers the basics.

Notifications You must be signed in to change notification settings

nab138/ProGrammar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ProGrammar

A mobile app to teach new programmers the basics in a fun and rewarding way.

Currently a WIP. I hope to release this on the app store/play store at some point, but no garuntees.

Todo for supabase migration

  • Offline caching

Usage

There is a web preview available. If youd like to run it nativley, see below.

On iOS

To install the app on iOS, you have two options based on your hardware:

Sidelaod with SideStore (Windows, Mac, or Linux)

  1. Follow the instructions at https://sidestore.io/#get-started to install sidestore on your phone. You can use the discord link on the website for help if you need.
  2. Once you have verified sidestore is working (try refreshing sidestore from within itself), download the latest ipa to your iphone from the "Artifacts" section of the latest actions run
  3. Go to sidestore, and click the plus in the top left corner of my apps, then browse to where you downloaded the ipa and select it.
  4. If all goes well, open ProGrammar!

Sideload with xcode (Mac only)

If you own a mac, you may find this option easier. It requires that you have installed and know how to use xcode.

  1. Clone this repository and cd into it. git clone https://github.com/nab138/ProGrammar && cd Programmar
  2. Install npm dependencies npm install
  3. Install the ionic cli npm install -g @ionic/cli
  4. Add ios support and build for ios ionic capacitor add ios && ionic capacitor build ios
  5. In the folder called ios, you will find an Xcode Project you can now open and install to your iPhone.

On android

I will not leave instructions here for this because I do not own an android, but it is well documented online as this app uses the ionic capacitor build system. If you have an android and test this, please report any bugs (especially UI bugs)

Development Usage

If you want to make changes, you can use the ionic development server that automatically refreshes when you make a change.

Pre-requisites: Node.js and npm

  1. Clone this repository and cd into it. git clone https://github.com/nab138/ProGrammar && cd ProGrammar (You can also use the download as zip or github desktop on windows)
  2. Install npm dependencies npm install
  3. Install the ionic cli npm install -g @ionic/cli
  4. Launch the development server: ionic serve
  5. A browser window will be automatically opened showing the app. If you want to simulate a phone, open devtools (Ctrl+Shift+I) and select a device at the top of the screen.