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 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.

Appchain Deployment

Your project should run as its own Initia appchain, with its own rollup identity and deployed application logic.

Frontend Experience

Your frontend should use InterwovenKit for wallet connection and transaction flows so the app reflects the core Initia user experience.

Native Feature

Your project should implement at least one supported Native Feature:

• auto-signing
• interwoven-bridge
• initia-usernames

Submission Files

Your repository should include:

• .initia/submission.json
• README.md at the repository root

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.

Submission JSON

Required file path: .initia/submission.json

Use this exact structure:

.initia/submission.json

{
  "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:

README.md

## 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.]