/Show-And-Sell

Digital Yard Sale app to fund FBLA

Primary LanguageSwiftApache License 2.0Apache-2.0

Show & Sell

Central High School
Keller, TX

Quick Reference

Overview

When we began this project, we began with the following specifications in mind:

Create a mobile application that would allow a platform for a digital yard sale to raise funds to attend NLC. The app should allow for the donation of items, including picture, suggested price, and a rating for the condition of the item. The app should allow for interaction/comments on the items. Code should be error free.

We believe that with Show & Sell, we have gone above and beyond these guidelines. Our application strives to be the most powerful, easy-to-use platform for hosting digital yard sales, thanks to its inclusion of the following features:

  • Item Donation, including a picture, suggested price, item condition, and more details about the item
  • Commenting threads on items
  • Bookmarking items for quick future reference
  • Full support for online purchasing using the Braintree Payments API
  • Creation of multiple yard sales/groups
  • Group management, including deleting, editing, and approving items in your group
  • Anti-abuse protections
  • Finding nearby groups based on the user's location
  • Searching for items and groups
  • Help section
  • Account creation and login with email or Google OAuth
  • Sharing items via Twitter
  • Deep links into the app from Twitter
  • Both Apple and Android versions of the app, each with a user-friendly UI that fits well with native design patterns

With Show & Sell, we empower FBLA chapters and other organizations to mobilize their members and the community to harness the power of mobile technology to raise funds from the sale of donated items.

Instructions for Installation

Prerequisites
  • Have a reliable internet connection
  • Have a computer running OS X 10.11.5 or later
  • Have Xcode 8 or later installed
  • Have the latest version of CocoaPods installed.
  • Have an iPhone/iPod or emulator running iOS 10.0 or later
Installation

After completing the requirements, perform the following to install:

  1. Clone the project by either
  • Downloading the project zipped, and unpackaging it into the desired directory
    OR
  • If you have git installed, navigating to the desired directory in Terminal and executing the following command:
    $ git clone https://github.com/mcjcloud/Show-And-Sell.git
  1. Navigate to the project directory (which includes a file named "Podfile") and execute the following command:
    $ pod install
  2. Open the project by double clicking on the file named "Show And Sell.xcworkspace" in the project directory
  3. Wait for Xcode to finish indexing (as can be seen at the top of the Xcode window).
  4. Click on root file in the Project Navigator (located on the left) named "Show And Sell" to open the project settings.
  5. Navigate to the "General" tab and change the Bundle identifier (currently "com.insertcoolnamehere.Show-And-Sell") to a new, unique identifier (i.e. "com.randomidentifier.Show-And-Sell")
  6. Once complete, select your device or emulator from the device dropdown in the top left of teh Xcode window and run the app by clicking the play button.
  7. If you're running on a real device, you must approve the developer profile before the app can run. Go to Settings > General > Device Management and verify the Provisioning Profile.

Once installed, the app will run for three days before the codesigning expires, and the app must be installed again.

Troubleshooting

Q: I created a brand new Bundle identifier, but the app still won't run.
A: Follow this link to create a Code Signing Identity (provisioning profile)

Q: Error "The run destination is not valid for Running the scheme 'Show And Sell'
A: Make sure you are using an iPhone/iPod running iOS 10.0 or later.

Q: Build error "custom shell scripts: Permission Denied" A: Be sure you successfully ran $ pod install with no errors in the project directory.

Q: Error "remote: Repository not found." when cloning project A: Be sure the repository is spelled correctly "https://github.com/mcjcloud/Show-And-Sell.git"

If problems persist, try deleting the project, and following the instructions again.

Software Used

  • Xcode 8 IDE
  • Visiual Studios IDE (for backend API)
  • GIMP Image Editor

Templates Used

  • No templates other than those provided by Xcode were used

Source of Information

Copyright Notations

Source Usage
icons8 Resource for TabBar icons, distributed under the Creative Commons Attribution-NoDerivs 3.0 License
Google Sign In SDK used for Google OAuth implementation, licensed under the Creative Commons Attribution 3.0 License
Braintree SDK used for implementing digital transactions, licensed under the MIT License