Multiplayer turn-based 3D fighting game for iOS

This project is my attempt to use the best and newest practices in Swift and popular third party libraries; Combine, Firebase (Firestore, Authentication, Storage, Crashlytics), and uses MVVM pattern.

1. Collada (.dae files) for 3D models and animations. Animations were downloaded from Adobe's Mixamo by uploading the character's .fbx file

2. Swift

   • App is mostly in SwiftUI, however, UIKit is required for SceneKit
   • SceneKit is Apple's 3D rendering engine
   • Combine is Apple's framework to handle asynchronous events declaratively
   • MVVM pattern, common SwiftUI pattern
   • Router pattern in charge of handling navigations and creating views which allows flexibility and testability
   • Codable mapping JSON or dictionaries into a Swift object
   • async and try await handling background tasks asynchronously
   • Result for error handling

3. Firebase

   • Firebase Firestore for database
     
     • Used Firebase's new property wrappers @DocumentID, @ServerTimestamp, @FirestoreQuery
   • Firebase Authentication for authenticating users. This app also features:
     
     • Register and log in accounts
     • Forgot email and password
     • Email/username authentication
     • Assign profile picture
     • Update unique username
     • Remember email/username and password
     • Reonboard unfinished account registration
   • Firebase Storage for storing user's photo and other files

1. Download repo
2. Download Swift Packages by going to File -> Add Packages and paste the links below
   
   • FLAnimatedImage (for GIFs): https://github.com/Flipboard/FLAnimatedImage
   • Firebase SDKs: https://github.com/firebase/firebase-ios-sdk
     
     • Make sure Add to Target's project these followung Package Products:
       
       1. FirebaseAuth
       2. FirebaseCrashlytics
       3. FirebaseFirestore
       4. FirebaseFirestoreSwift
       5. FirebaseStorage
3. Add GoogleService-Info.plist to the Xcode project by either:
   
   1. Contact samuelfolledo@gmail.com for a copy of the file
   2. Create your own Firebase project here and download its GoogleService-Info.plist into your Xcode project. Ensure to enable Firestore, Storage, and Authentication for email and password in the Firebase project

1. Each round before the timer runs out, both players can select up to 1 attack and 1 defense move
2. When the current round's timer runs out, damage is applied to opposing enemy's HP depending on each player's selected moves. Selected moves also goes into cooldown at the end of the round
3. Attack rules:
   
   1. There are 3 types of attack: light, medium, and hard.
   2. Light type of attacks are faster but does lesser damage, meanwhile hard type of attacks does more damage but are slower. Cooldown are also longer for hard attacks compared to light attacks.
   3. Landing an attack first gives the attacker a slight speed boost for next round and reduce incoming damage based on attack type. Hard attacks will reduce incoming damage much more than light attacks
   4. Some attacks can boost the damage of attacks that are not on cooldown for the next round indicated with fire
   5. Each attack type can land either left or right
4. Defense rules
   
   1. There are 4 types of defense: left, right, up, down
   2. Defense type: left or right defense move can dodge an attack and receiving 0 damage
   3. Defense type: up will increase your speed, increase damage dealt, and damage received
   4. Defense type: back will reduce your speed and reduce incoming damage
5. The game ends when one of the player’s HP reduces to 0
6. This game will never result to tie

• Uses Firebase’s Authentication for authentication
• Account creation requires a unique username, unique email, and password. Profile picture is optional
• Email or username along with a password can be used to authenticate
• Account created but incomplete (i.e. user name was not set), after logging in, the app will transition to finishing account creation
• User’s data are stored in Firebase Firestore and profile picture in Firebase Storage

• Deleting accounts gets their Firebase Firestore’s data, Firebase Storage’s profile picture, and Firebase Authentication’s account permanently deleted
• Locally stored account data and remembered email/password are permanently deleted
• Account deletion requires a recent authentication before performing

• Username authentication fetches the user’s email using the unique username, then use that email along with the password to authenticate
• Logging in fetches user’s data from Firebase Firestore, user’s profile picture from Firebase Storage, and store cache them locally
• With remember email and password feature which gets updated when updating the user’s username

• Recent authentication is required in order to update account
• Update email and profile picture is also supported

• Firebase Project
• Stackoverflow: How to use a .dae file on Xcode

iOS app that sends Slack notifications when mail is delivered. Designed to improve mail system in Make School student housing.

• With an image of a mail or shipping label captured by the camera, this app uses Firebase's VisionTextRecognizer API to return all texts found from the still image. With an algorithm I wrote, the app will show the name it predicts on a text field to allow editing. Once the user confirms the name is correct and clicks send, the app will request a GET to SnailMail's backend developed by Genji to find the name given and send a Slack message.

• UI/UX Programming Language - Swift
• Backend Programming Language - Python
• API Framework - Flask
• Slack Bot - SlackBot API
• Database and Storage - Firebase
• Firebase's Text Recognizer Firebase/VisionTextRecognizer

• This demo shows how the app captures an image and using Machine Learning and name finder algorithm I wrote, displays the name found from the mail. It also shows a Slack message received with the address written on the mail.

• This demo shows how the app works with any type of mail or shipping labels and how the name can be updated if for some reason, the name it captures is wrong. It also demonstrates in the Slack message's address matches the mail's address.

• This demo shows secondary screens like larger image and list of all mails scanned which can be swiped to delete, or delete all with animations.

License under the MIT License

• This is a more modern and SwiftUI version of my UserAuth-Starter that uses Swift's new way of handling concurrencies async await
• It also handles many errors like requiring reauthentication before making account changes
• This also have a way to log in using username, forget password, and a remember me feature
• And so much more

1. Download repo
2. Download Swift Packages by going to File -> Add Packages and paste the links below
   • Firebase SDKs: https://github.com/firebase/firebase-ios-sdk

• Hackathons participants that wants to have a quick Firebase User Authentication built in your app with as little effort and time wasted as possible
• Prototyping apps to immediately see a live app with P2P features and connectivity
• Learning Firebase Authentication: email login/register, Facebook login/register, phone login/register, anonymous signin

1. Fork and Change Directory in Terminal
2. Install the pods in the terminal by running: $ pod install
3. Create Project in Firebase
4. Enable Authentication and Real Time Database
5. Test

• To be safe, run the following commands to ensure all pods are up to date

pod update 

• Facebook For Developers

  • Firebase's Instructions for Facebook Login

• Google Sign-In for iOS

  • Firebase's Instructions Google Signin Instructions
  • Sometimes turning a UIButton in storyboard to a GIDSignInButton does not work, so open the storyboard file as a Source Code and customize it there

• Sign in With Apple - only works for members with Apple Developer Program

  • Firebase's Instructions for Sign in With Apple
  • Apple Signin video reference
    1. Enable Apple Signin in Firebase
    2. Add Sign In With Apple capability in you Xcode project's Signing & Capabilities
    3. In Apple Developer, signin and look for your projecct. Enable Signin With Apple in Identifiers list
    4.  
  • Apple Signin video reference - SwiftUI and FireStore

• Used these as reference

  • Facebook Signin Video pt 1
  • Facebook Signin Video pt 2
    • Note that Facebook updates very often, so keep checking for future updates
    • You will need to create your app in Facebook For Developers
    • In developers.facebook.com, you will also need to go to your project's Settings and see the Client OAuth Settings and paste OAuth redirect URI from Firebase's project -> Authentication -> Sign-in method -> Facebook (e.g.https://folledouserauth.firebaseapp.com/**/auth/handler) into Valid OAuth Redirect URIs
    • You will also need to remove my 2 Facebook code blocks in Info.plist file and put yours instead.
    • Fetching the Facebook User Data
  • Google Signin Video

Don't forget to:

• to paste Google-Sevice-Info.plist's REVERSE_CLIENT_ID's value in the project -> Info -> URL Types -> + //Comitted on January, 4 2019
• APNs Certificates are required to be uploaded in your Firebase project's Project Settings -> Cloud Messaging -> iOS app configuration which needs to be updated annually //Comitted on January, 4 2019
  • Configuring APNs with FCM

Notice how phone, email is supported as well as Apple and Google under one email. 

Where users can select from either Sign In with Apple, Facebook, Google, Phone, or Email. Using Facebook or Google will take your profile picture if allowed

Signin or register via phone or email authentication. It will know if phone or email already exist in the database, and will either log in or register user accordingly.

User can view their profile picture and logout. (Upcoming features are, delete account from account settings, update names and profile picture)

License under the MIT License

iOS app that uses newsapi.org to show news all over the world

Features

• Newest and most updated news thanks to newsapi.org
• Search functionality
• One click by category, country, language, news source
• Easily filter articles by dates
• Sort by relevancy, popularity, or newest articles

Full Demo	Article List

• MOB1.3
• Rubrics

License under MIT License

A todo app that utilizes CoreData for persisting projects and tasks with local notifications. Never forget a task you have to do ever again!

• CRUD projects and tasks and persist them using Core Data
• Get a 24 hours and 5 minutes before any tasks are due
• Search projects and tasks
• Dark Mode support
• Colorful

Full Demo	Dark Mode Demo

• My final project for my MOB 2.1 - Local Persistence in iOS in MakeSchool
• Rubrics

License under MIT License

Brain Training Game for iOS written in Swift that trains your brain and hand-eye coordination.

Features

• Different game difficulties
• High score functionality for each difficulties
• Basic animations
• Transition animations

• Easy: White Cards
• Medium: White and Black Cards
• Hard: Green, Red, Black, and White Cards

• Requirements
• Stroop Effect
• Sample Implementation: Color Match

Lincense under MIT License

A clone of the popular mobile game Timberman. Used Apple's Swift programming language together with SpriteKit, their game development framework.

• Timberman clone
• Avoid getting hit by the chopstick
• Tap left side or right side of the screen
• Keep track of score
• Health drops gradually overtime
• Health recovers each successful punches
• Animations on punch and removing sushis
• Interactive and challenging
• High score functionality

• Sushi Neko Tutorial - Make School

iPray is a guided prayer iOS app that will help user with their prayer by tracking the time you spent praying and log your prayer requests

• High score functionality
• Every day, more meteor falls
• Meteor explodes in three ways: on tap, when it hits Earth, or leaves the screen
• Fun explosion effects
• Interactive and challenging

License under the MIT License

Swift strings utility written in Go which automates boring Swift strings tasks like:

• Feature 1: Constantify Strings Creates global constant variables from all .swift files to a constant file
• Feature 2: Localize Strings Transform all valid translatable strings as NSLocalizedString and copies them to all Localizable.strings files while avoiding duplicated strings
• Feature 3: Translate Strings Uses Google Cloud Translation to automatically translate all strings in all Localizable.strings, allowing iOS, MacOS, etc apps to support multiple languages in a few seconds

• Avoid unintended typos
• Have strings autocompleted
• Easily manage all your strings in one file
• Auto generate strings Localizable.strings and avoid duplicate strings
• Automatically translate all strings in Localizable.strings

• clone the repo

$ git clone https://github.com/SamuelFolledo/StringsUtility $ cd StringsUtility 

• Make sure HomeBrew is updated

$ brew update $ brew install golang 

• Set up a Cloud Console project
• Download a private key as JSON
• While inside StringsUtility directory, run in terminal once

$ go get -u cloud.google.com/go/translate 

• Important: Run this command once each fresh terminal. Replace the [PATH] to the path of the .json file downloaded from setup 2 step 3. Instructions for more info or for Windows setup

  export GOOGLE_APPLICATION_CREDENTIALS=[PATH] 

   
  For example:

  export GOOGLE_APPLICATION_CREDENTIALS=/Users/Samuel/Downloads/StringsUtility-Tester-785c7f11aedf.json 

   

For further details, tips, recommendations go to Tips and Requirements

• run the program locally replacing [PATH_TO_YOUR_PROJECT] with your project directory

  $ go build && go run main.go -dir=[PATH_TO_YOUR_PROJECT] 

   
  For example:

  go build && go run main.go -dir=/Users/macbookpro15/Desktop/StringsUtilityTester
  
  

  Tips and Requirements

  • Currently does not support multi line strings
  • To avoid unnecessary translation, strings which contains substrings like file extensions, keywords, and symbols will not be translated. Edit strings and files to follow these standards.

    "/", "", "{", "}", "_", "#", "%", ".swift", ".xib", ".storyboard", ".jpg", ".jpeg", ".png", ".mp4", ".mp3", ".wav", ".mov", ".gif", "http", "https", ".com", "identifier" 

     
  • Strings like url, identifiers, and more which contains substrings like the following will not be constantify.

    "/", "", "{", "}", "http", "https", ".com", "#", "%", "identifier" 

     
  • Suported Languages

  For more tips and requirements click here

  Links

  • MakeUtility Requirements
  • My article: 5 Steps to Localizing your Swift Apps

An ecommerce store app, inspired by Supreme store app, with extra features I developed for my friend Kennedy Ngo's clothing business, "Elevated Era".

• Unlike Supreme App store, you can customize the quantity in the cart as well as save user information and address without the need of creating an account 

License under the MIT License

An addicting online game playable on 2 different devices or on the same device. Inspired by a child's Rock Paper Scissor game but with twice or maybe more the possibilities and moves to choose from. Meaning, you will lose at least 1 if not all games every 10 games you play

It's very simple,

1. Pick one move and one attack move each round before the timer runs out.
2. First player to drop to 0 HP loses

• Can't decide with your partner who's going to wash the dishes or do the laundry? Play the game and whoever loses do both chores.
• Can't decide with your mom if you should drop out of college? Play the game and if you win, drop out, if she wins get the degree as a Cum Laude
• Can't decide who's paying the restaurant bill? Play the game and whoever loses pays for it and buys the winner a desert.
• Can't decide what movie to watch? Play the game and if you lose, then watch a movie you would never watch

Flow and fiero

• Reward system for leveling up
  • At level 5 allows you the group chat room
  • At level 8, unlock your own house
  • At level 10 unlock Pet room
  • At level 20 unlock 2nd floor
  • At level 50 unlock Mansion mode
• Reward system for consistent playing time
• Reward system for playing more games in one day
• Different game modes
  • Normal mode
  • Fast mode
  • Super saiyan mode

License under the MIT License