# Devpost Guide

## Devpost Guide

This guide explains how to use Devpost for HackHCC: how to sign up, register your team, and submit your final project. It cleans up the quick notes and screenshots so teams can register early and edit their submission before the final deadline.

**Devpost event page:** Will be posted on the day of the event.

***

### 🤔 What is Devpost?

Devpost is an online platform where developers showcase projects, participate in hackathons, and connect with companies and other builders. For **HackHCC: CodeRunners**, we use Devpost to collect team registrations and final project submissions.

> ℹ️ **Info**
>
> If you need help at any point, ask a HackHCC officer or reach out through the event channels.

***

### 🙋 Frequently Asked Questions

**When do I have to register my team?** Your team needs to be registered on Devpost by (**TBD**) **on TBD!** When registering your team, please choose all the Companies and Tracks you are most interested in competing for. If you are unable to, don't worry, you have until the end of hacking to create your post.

**Can I only submit my project one time?** No! You can submit your project and edit it as many times as you want before the final deadline (TBD). We encourage you to submit your project as early as you can to ensure you are registered.

**Does everyone on my team need to submit on Devpost?** Nope! You only need **one submission per team**. Please make sure to invite your teammates to your submission so they are eligible for prizes.

**Can I submit more than one project?** Unfortunately, we only allow one submission per team.

**How many tracks can I submit to?** Up to **2 sponsor tracks**, but as many general tracks as you want to.

***

### 👶 New to Devpost? (Step-by-step)

Welcome to this step-by-step guide on how to setup and create a Devpost submission!

1. **Sign up for an account:** Visit the HackHCC: CodeRunners Devpost website and create an account using your email or social media profiles.
2. You will be prompted to complete your profile. Please fill out your profile with all your details.
3. **Let's join the hackathon!** After creating your account, navigate back to the HackHCC Devpost page and click the `Join Hackathon` button.

*(Join Hackathon Button Placeholder)*

If you don't already have a Devpost account, you will be prompted to create one. If you already have an account, simply log in. Fill out the short form and register.

*(Registration Form Placeholder)*

***

### 🧑‍🤝‍🧑 Registering Your Team (Quick Method)

To register your team, you just need to create a blank project with the companies you are interested in and submit it! This will be editable until the end of hacking time (TBD). We do this to avoid any last-minute issues with Devpost and to gauge interest in company challenges.

> ⏳ **Deadline Reminder**
>
> We would like for your team to be registered on Devpost by TBD **on** TB&#x44;**!** When registering your team, please choose all the Companies and Tracks you are most interested in competing for.

1. In Devpost, go to "My Projects" and click **Create Project**.
2. **Invite teammates:** Open "Manage Team" and invite all teammates *(required for prize eligibility)*.
3. **Project Overview:** For a registration-only project, you can set the title to your team name or "Team Registration" and use the elevator pitch to list teammates or a short idea.
4. **Project Details:** Fill required fields with placeholder text such as "Team registration" if you don't have final copy yet.
5. **Additional Information:** Choose the sponsor tracks you are considering (select at most 2 sponsor/company tracks). For now, you can use a placeholder video link (replace it later with your final demo) and a placeholder repository if needed.

> 💡 **Tip**
>
> Creating a registration project early helps avoid last-minute Devpost issues and helps organizers gauge interest in company challenges.

***

### 🚀 Submitting Your Final Project

Before you submit, make sure the following are ready:

* Project title and short description
* **Public** repository link **(required)**
* A demo video link (public YouTube or similar) — *2 minutes max is recommended*
* Screenshots or images to showcase the project
* Team members and their schools *(for eligibility tracking)*

#### Steps to Finalize Submission:

1. In "My Projects", click **Edit Project** on your project.
2. **Fill out Project Overview:** Add a thumbnail (optional but recommended), the full project description, and technologies used.
3. **Use Markdown for Project Details:** Devpost supports Markdown. Briefly describe what you built, how to run it (if applicable), and which parts are functional vs. prototypes. Upload images to illustrate the project.
4. **Additional Information Page:** Choose sponsor/company challenges you want to be judged for *(remember: selecting the company here is required for being considered for that company's challenge)*. Add your public repository and list the schools of teammates.
5. **Agree to terms and submit.** You can still edit until the end of hacking (TBD) — confirm the exact editable deadline on the event page.

***

### ✅ Checklist Before Final Submission

Complete these before you finalize your Devpost post. Check items as you go.

#### Essentials

* [ ] Team registered on Devpost
* [ ] All teammates invited to the project
* [ ] Public repository linked **(required)**

#### Media & Presentation

* [ ] Demo video uploaded and linked (public)
* [ ] Screenshots or GIFs added
* [ ] Project thumbnail (optional but recommended)

#### Submission Details

* [ ] Sponsor/company tracks selected (≤ 2 company tracks)
* [ ] Schools added for each teammate

***

### 🛠️ Troubleshooting & Tips

* **Don't leave the repository private.** Submissions with private repos risk disqualification.
* **Submit early and update:** Devpost allows edits, so submit a working version early and iterate.
* If a teammate doesn't appear as invited, double-check their Devpost account email and resend the invite.
* If you run into Devpost technical issues, try a different browser or clear your cache. Contact HackHCC officers if the issue persists.

### ❓ Need Help?

If anything is unclear, ping a HackHCC officer or post in the event communication channels. We're happy to help with invites, registration, and submission checks.

**Happy Hacking!**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hackhcc.gitbook.io/hackhcc-docs/essential-resources/devpost-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
