> ## Documentation Index
> Fetch the complete documentation index at: https://docs.initia.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Submission Requirements

Use this page to prepare your final submission. Complete the required
submission files and fill in any missing details before you submit.

## Requirements

If you followed [Set Up Your Appchain](/hackathon/get-started) and completed
one of the Blueprint tutorials, you likely already satisfy the first three
requirements below: appchain deployment, frontend experience, and native
feature. Use this section to verify those pieces and complete the required
submission files.

<CardGroup cols={2}>
  <Card title="Appchain Deployment" icon="diagram-project">
    Your project should run as its own Initia appchain, with its own rollup
    identity and deployed application logic.
  </Card>

  <Card title="Frontend Experience" icon="display">
    Your frontend should use `InterwovenKit` for wallet connection and
    transaction flows so the app reflects the core Initia user experience.
  </Card>

  <Card title="Native Feature" icon="bolt">
    Your project should implement at least one supported Native Feature:

    * `auto-signing`
    * `interwoven-bridge`
    * `initia-usernames`
  </Card>

  <Card title="Submission Files" icon="file-lines">
    Your repository should include:

    * `.initia/submission.json`
    * `README.md` at the repository root
  </Card>
</CardGroup>

<Note>
  **Showcase your app's originality:** Projects that only reproduce a Blueprint without
  meaningful customization are not eligible for prizes. Your submission should
  include clear custom logic, UX, or product differentiation.
</Note>

## Submission JSON

Required file path: `.initia/submission.json`

Use this exact structure:

```json title=".initia/submission.json" theme={null}
{
  "project_name": "My Project",
  "repo_url": "https://github.com/<org>/<repo>",
  "commit_sha": "0123456789abcdef0123456789abcdef01234567",
  "rollup_chain_id": "my-game-1",
  "deployed_address": "0x...",
  "vm": "move",
  "native_feature": "auto-signing",
  "core_logic_path": "blockforge/sources/items.move",
  "native_feature_frontend_path": "blockforge-frontend/src/Game.jsx",
  "demo_video_url": "https://youtu.be/..."
}
```

## Submission JSON Field Reference

All fields in `.initia/submission.json` are required.

| Field                          | Expected value                                                                                                           |
| :----------------------------- | :----------------------------------------------------------------------------------------------------------------------- |
| `project_name`                 | Non-empty string                                                                                                         |
| `repo_url`                     | Reachable public GitHub repository URL                                                                                   |
| `commit_sha`                   | 40-character hex Git commit SHA                                                                                          |
| `rollup_chain_id`              | Non-empty string                                                                                                         |
| `deployed_address`             | Primary deployed address for your application logic. Use your contract address, or your module address for Move projects |
| `vm`                           | `move`, `evm`, or `wasm`                                                                                                 |
| `native_feature`               | `auto-signing`, `interwoven-bridge`, or `initia-usernames`                                                               |
| `core_logic_path`              | Repo-relative file path that must exist at `commit_sha`                                                                  |
| `native_feature_frontend_path` | Repo-relative file path that must exist at `commit_sha`                                                                  |
| `demo_video_url`               | Public Loom or YouTube URL for a 1 to 3 minute walkthrough video                                                         |

## Project Description

Required file path: `README.md` at the repository root

Copy this block near the top of your `README.md` and fill it in:

```markdown title="README.md" theme={null}
## Initia Hackathon Submission

- **Project Name**: [Your Project Name]

### Project Overview

[Provide a 2-3 sentence description of your application, the problem it solves,
who it is for, and why it is valuable to users.]

### Implementation Detail

- **The Custom Implementation**: Briefly describe the unique logic you added.
  What original functionality did you design and implement?
- **The Native Feature**: Which Interwoven feature did you use, and exactly how does
  it improve the user experience?

### How to Run Locally

[Provide 3-4 clear steps for a judge to run your frontend and connect it to a
local environment if necessary.]
```