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

Developers

Quick Guides

VM Specific Tutorials

Integrating with Initia Apps

Tools

Programs

Submission Requirements

Requirements

Appchain Deployment

Frontend Experience

Native Feature

Submission Files

Submission JSON

Submission JSON Field Reference

Project Description

​Requirements

Appchain Deployment

Frontend Experience

Native Feature

Submission Files

​Submission JSON

​Submission JSON Field Reference

​Project Description

Requirements

Submission JSON

Submission JSON Field Reference

Project Description