NitroStack × Amrita Hackathon Starter

NitroStack × Amrita Hackathon Starter

A verified, event-ready base for building a TypeScript MCP server with theofficial NitroStack SDK. The included calculator module is a working reference,not the final hackathon idea.

Live deployment

• Service documentation:https://nitrostack-hackathon-starter-6a63c210-vedangs-org-ddf9f8a5.app.nitrocloud.ai
• Streamable MCP endpoint:https://nitrostack-hackathon-starter-6a63c210-vedangs-org-ddf9f8a5.app.nitrocloud.ai/mcp
• NitroCloud app:https://cloud.nitrostack.ai/apps/6a63c210b7c23ca10dce7c5e

The service runs MCP protocol 2025-06-18. A live smoke test initializes theserver, lists both tools, and executes 5 + 3 = 8.

Ready on this laptop

• Node.js 20.18.1 and npm 10.8.2
• Git and GitHub CLI
• VS Code
• NitroStudio 1.4.14
• Official NitroStack CLI 1.0.15 installed globally
• Official typescript-starter template
• Root and widget dependencies installed
• Local build, preflight checks, and GitHub Actions CI
• Idea, build, security, submission, and three-minute demo templates

Start here

1. Complete the short account checklist.

2. Fill in the one-page idea brief with your team.

3. Replace the calculator example with the smallest end-to-end version of yourchosen idea.

4. Run:

   npm run dev
   

5. In NitroStudio, choose Add Server → Nitro Project, select this folder,and open Studio App Canvas.

Before every push:

npm run check

Project map

src/
├── index.ts
├── app.module.ts
├── health/
├── modules/
│   └── calculator/        # Replace with your MVP module
└── widgets/
    └── app/
docs/
├── IDEA.md
├── BUILD_PLAN.md
├── MANUAL_ACCOUNT_STEPS.md
├── PIZZA_REFERENCE_WORKFLOW.md
├── SUBMISSION_CHECKLIST.md
└── DEMO_SCRIPT.md
scripts/
└── preflight.mjs

Commands

Non-negotiable event rules

• Use the official NitroStack TypeScript SDK throughout the project.
• Align the idea with an organizer-approved track.
• Keep main working and deployable.
• Deploy early to NitroCloud and test the live service after major changes.
• Never commit .env, API keys, tokens, passwords, credentials, private keys,node_modules, or large binaries.
• Keep the repository public through judging.
• Submit the live NitroCloud deployment, complete GitHub repository, and a demovideo no longer than three minutes through the organizer-provided account.

See SUBMISSION_CHECKLIST.md for the full gate.

Official links

• NitroStack documentation
• NitroStack quick start
• NitroStudio
• NitroCloud dashboard
• NitroStack Discord
• Coimbatore hackathon page