Central High School
Keller, TX
- Overview
- Instructions for Installation
- Troubleshooting
- Software Used
- Templates Used
- Source of Information
- Copyright Notations
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.
- 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
After completing the requirements, perform the following to install:
- 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
- Navigate to the project directory (which includes a file named "Podfile") and execute the following command:
$ pod install
- Open the project by double clicking on the file named "Show And Sell.xcworkspace" in the project directory
- Wait for Xcode to finish indexing (as can be seen at the top of the Xcode window).
- Click on root file in the Project Navigator (located on the left) named "Show And Sell" to open the project settings.
- 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")
- 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.
- 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.
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.
- Xcode 8 IDE
- Visiual Studios IDE (for backend API)
- GIMP Image Editor
- No templates other than those provided by Xcode were used
- Apple API Reference - for reference of iOS APIs and general knowledge
- Google Sign-In for iOS - for implementing Google OAuth sign in support
- Twitter Developer Documentation - for implementing item tweeting and Deep-Links
- StackOverflow - for debugging
- Braintree Developer Documentation - for implementing digital transactions
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 |