Pi Hackathon

 

#PiHackathon is an ongoing Pi Network initiative that is designed to facilitate year-round Pi ecosystem development efforts and provide regularly accessible opportunities for developers. Passionate developers and builders can participate monthly in this process by submitting their Pi Apps through the Brainstorm app. Your submissions can be available for review by our community of tens of millions of Pioneers. Winning the hackathon in a given month can bring additional visibility to your project. Let’s build Pi utilities together!

Challenge

We’re looking for creative, utility-focused web apps that address a real user need, support the use of Pi cryptocurrency, and are intuitive to use and accessible to everyday people.

Prizes, Rewards and Benefits

Winning projects will win an overall prize of 10,000 Pi

Benefits

As part of our developer support programming, all Hackathon submissions will be considered for the opportunity to receive additional support and resources from the Pi Core Team. Strong apps that meet the necessary criteria will also be eligible to be listed on Testnet Ecosystem in the Pi Browser. Teams can continue to build on their apps even after they submit; if they do not win one month, their improved app can win another time.

*Subject to other terms and conditions set forth in the terms of service for the Hackathon which can be found in the Brainstorm.pinet.com app

Resources

Developer Onboarding Guide: Details the steps needed to get set up as a new developer in the Pi Ecosystem

Getting Started Checklist: A quick start guide of the steps needed to start building on Pi

Pi Platform Github Repository: Our developer documentation that has all of the information needed to integrate our Pi SDK and our APIs

Pi Demo App Repository: Review or clone our demo application code as a blueprint for your apps. To play with it, navigate to “demo.pi” within the Pi Browser

PiOS: Learn about the Pi Open Source software license and how to use it

SDK Workshop: Watch a presentation on how to use the Pi SDK

Product Workshop: Watch a product design guide for Pi Apps, tailored for hackathon participants

Instructions

Onboarding Instructions

Follow these important steps to get started with your Hackathon project and get set up in the Pi Ecosystem.

Download the Pi App and create a Pi Account (Apple App Store or Google Play)

If you haven’t already, set up the Pi Browser (the home of the Pi ecosystem)

Download the app (Apple App Store or Google Play)

Sign in to the Pi Browser with your Pi Account (instructions here or in this video)

Go to the Pi Browser home screen and enter the Brainstorm app by tapping the Brainstorm icon

Tap on the “Hackathon” button in the navigation bar

Follow the instructions in the Hackathon tab for how to participate in the hackathon

Propose a Project Idea

Tap the “Propose” button in the navigation bar (bottom left corner) to create a project for the continuous Hackathon

Join a Project

Join an existing team by scrolling through the projects under the “Hackathon Proposals” filter

Select the project you wish to join, and fill in the “Skills you can provide” and “How can you help” sections to tell the existing project members more about your skills and experience.

If your request is accepted by the team admin, you can tap “Open Project Chat Room” to start collaborating

Dev portal

Follow these instructions to create a project in the Developer Portal, and to add a Demo App link to your Brainstorm submission.

Navigate to the Developer Portal (develop.pinet.com) within the Pi Browser

If visiting for the first time, read and accept the terms and conditions

If you haven’t created an app before, tap “New App” and make sure to select “Pi Testnet” as the App Network

On the app dashboard for the app you wish to edit, press the “Configuration” button

Scroll to the field titled “Your App’s URL”, and enter the URL of your application

The URL cannot be the same as another URL already in use by a Developer Portal project. If you have a Testnet and Mainnet application, you should use the URL that you wish users to use to access your Mainnet application. The Testnet app should use a subdomain of the Mainnet app or a completely different URL

You must own this URL; you will be asked to verify ownership later

Press the “Submit” button, this will return you to the app dashboard

Press the “Checklist” button

Tap on “Validate Domain Ownership”

Follow the instructions on how to validate your domain

Copy the validation-key string and save it in a file titled validation-key.txt

Add the .txt file to your application and launch the application

It is important to relaunch your application if it is currently deployed because you need the .txt file to be added to the site.

Once the .txt has been added to the site and is accessible press “Verify Domain”

Once verified, your application will be accessible in the Pi Browser

If you have a Mainnet App and a Testnet App for the same application, these projects should be linked. To link a Mainnet Developer Portal App to a Testnet Developer Portal App follow these instructions:

Select the Mainnet Version of the app from your list of apps in the Developer Portal.

Tap the “Configuration” button

Connect the Mainnet app to the Testnet app via the “Paired Testnet App” field

Submission

In the Pi Brainstorm App, ensure your project summary is up to date

Add a link to your YouTube presentation video in the “Presentation video” field

Ensure that you have linked your app URL from the Dev Portal in your Brainstorm project. Follow the “Developer Portal Instructions” for the steps on how to link this

If you are using the PiOS license, add a link to your Github repository in the “Github repo” field

Tap the “SUBMIT PROJECT TO HACKATHON” button, then tap “CONFIRM” when you are ready to submit

Submission Requirements

Participants must submit their app by following the submission instructions above by 11:59pm PST on the last day of each month

In order to be reviewed and be eligible for a prize, submissions must include a link to a demo app (either Testnet or Mainnet), a short video presentation, and a description of the app

Video presentation should include:

Overview of your project (what is it?)

How did you integrate Pi into your project?

Demonstration of the app functionality and user-flow

Brief overview of your tech

From a technical perspective how do you solve the key problem?

What unique features have you built into your app?

What major product qualities or achievements do you want to highlight?

This video should be no longer than 3 minutes

If the app is using the PiOS license, the users must indicate this in their Brainstorm project, and must include a link to the Github repo for this project

PiOS

The Pi Open Source (PiOS) Software License allows Pi Community Developers to create Pi Open Source applications and tools for the Pi Ecosystem. The PiOS license grants unrestricted use of the software only within the Pi Ecosystem. Developers are encouraged to use this license when developing a Pi App as well as build on top of the various PiOS applications and tools shared by other Pi Community Developers. Follow the instructions below to use the PiOS license.

Create a Brainstorm Proposal for the project if you haven’t already

Projects without a Brainstorm proposal link will not be accepted

Follow the instructions here https://github.com/pi-apps/PiOS

The Pi Core Team will review submissions, and if accepted, merge the PR

The Pi Core Team will create a new repository for your project within the pi-apps github organization. The github account that submits the PR will get admin access to the newly created repository with full rights to control their repository, such as inviting their team members, editing, adding or accepting code from the community, or even moving or deleting their repository

Develop your project within this repository. You can maintain your application from this new repository and receive, review, and accept PRs from other contributors.

Note: Your app name may not start with “Pi”. Read the Pi Network Trademark Guidelines for more information.

Add the PiOS license file to the project repository

Update the license with the required information

When ready to submit your project, follow the steps in the Submission Guidelines above.

App Requirements and Guidelines

Apps must abide by our Trademark Guidelines

Apps may never request Pioneers to enter their passphrase

If making in-app payments:

Apps must use only Pi SDK for payments; apps may not charge with non-Pi assets or currencies (exceptions rare and case-specific).

If user authentication is needed:

Apps must use only Pi SDK for authentication; there should be no app-specific account or login needed, or additional account creation

Apps must be deployed on the testnet, outside of the sandbox, for pioneers and reviewers to interact with the app.

App has functional UI and supports user interactions

App should be minimally functional

Apps must be unique with distinct use cases, avoid merely cloning existing ones

Apps must adhere to our recommended data collection guidelines and may NOT collect any user data beyond what is necessary for core functionality

App name should be in English characters

App should have a Logo, which is compliant with trademark guidelines

App should have an accurate description in English

App Preview/Demo Images that showcase the UI and UX of the application

App has a Privacy Policy