Bolt.new Tutorial5 min setupNo-code friendly

Add HIN OCR to Your Bolt.new App in 5 Minutes

Bolt.new scaffolds your full-stack UI. StructOCR reads the boat hulls. Here's the exact prompt and API call to wire them together — right in your browser.

Diagram showing a boat transom photo uploaded in a Bolt.new app, sent to the StructOCR API, and returned as structured JSON containing the parsed HIN and manufacturer details.
Upload → parse → display: the full flow takes a single API call.

Why Bolt.new + StructOCR is a natural fit for Marine Apps

Bolt.new generates and runs full-stack web applications directly in your browser. It handles the UI, components, and package management automatically — but extracting a 12-character Hull Identification Number (HIN) from weathered fiberglass is something you have to wire up yourself. StructOCR fills exactly that gap: one API call, structured JSON back. Tell Bolt what you want, paste in the fetch code below, and your marine app is ready.

The problem: Standard AI can't read embossed fiberglass

Tools like Bolt.new are remarkable at generating apps instantly — but they stop at the file boundary. You can build a beautiful marina management interface in minutes, yet the actual extraction of a Hull Identification Number (HIN) from a reflective gel coat, painted-over metal plate, or weathered transom requires a dedicated HIN OCR API. Standard vision models routinely fail to distinguish shallow engravings from background noise.

The solution: Marine-grade precision and parsing

StructOCR's /v1/hin endpoint accepts a photo and returns a clean JSON object with the validated HIN, plus it automatically breaks down the code into the Manufacturer Identity Code (MIC), serial number, and production dates. Because it speaks plain HTTP, Bolt.new can wire it up from a single fetch call without heavy backend dependencies.

Integrate StructOCR in Bolt.new (3 Steps)

  1. Create a Bolt.new project and describe your app

    Open bolt.new and start a new prompt. Describe the marine tool you want to build — be specific about the scanning interface.

    Try this prompt: "Build a mobile-friendly HIN scanner app. Users can upload a photo of a boat's transom, and the app will display the extracted HIN, manufacturer code, and production year."
  2. Tell Bolt to call the StructOCR API

    Once Bolt scaffolds the UI, paste the follow-up prompt below. Bolt will write the fetch call, handle the file upload, and wire the response to your UI components in its in-browser editor.

    Follow-up prompt: "When a user uploads an image, send it as a multipart/form-data POST to https://api.structocr.com/v1/hin with an Authorization header containing my API key. Display the returned JSON fields in the results panel."
    // Bolt generates something like this — you just supply the key in .env const response = await fetch('https://api.structocr.com/v1/hin', { method: 'POST', headers: { Authorization: `Bearer ${import.meta.env.VITE_STRUCTOCR_KEY}` }, body: formData, });
  3. Add your StructOCR API key to your environment

    In the Bolt.new file explorer, create or open the .env file to securely add your StructOCR key. The app will automatically reload with your live scanner.

    Variable name: VITE_STRUCTOCR_KEY — get your free key at structocr.com/dashboard
    VITE_STRUCTOCR_KEY=sk_live_xxxxxxxxxxxxxxxx

What you can build in Bolt.new with this integration

  • Boat dealership inventory: Let staff snap a photo of a vessel's transom to instantly log it into the inventory system, automatically decoding the model year and manufacturer without manual typing.
  • Marine insurance claims: Add an upload step to a self-service claims flow: extract the HIN automatically from the policyholder's photos to verify the insured vessel. A perfect fit for marine automation.
  • Marina & dock management: Build a mobile app for dockmasters to scan visiting boats to ensure they match registered tenant records and verify vessel age.
  • Vessel registration portal: Create a tool that validates HIN formats on the fly for state or federal boat registration compliance.

The prompt and the code

Copy the follow-up prompt into your Bolt.new chat to generate the integration. The code block shows what Bolt typically produces — useful if you want to verify or tweak it.

Prerequisite: A free StructOCR account — get your API key at structocr.com/dashboard (no credit card required)

I need to add HIN OCR to this app.

When a user uploads an image:
1. Send it as multipart/form-data to: POST https://api.structocr.com/v1/hin
2. Include the header: Authorization: Bearer ${VITE_STRUCTOCR_KEY}
3. The response is JSON with fields: data.hin_number, data.is_valid, data.parsed.manufacturer_code, data.parsed.model_year
4. Display the extracted HIN and the decoded manufacturer/year in the results panel
5. Show a loading spinner while the request is in flight
6. Show an error message if the upload fails

Use the environment variable VITE_STRUCTOCR_KEY for the API key.

What the API returns

Not just the raw string—the API automatically decodes the manufacturer and production dates. Your Bolt.new app can bind this directly to the UI components.

{
  "success": true,
  "data": {
    "hin_number": "US-TNPD7474B899",
    "is_valid": true,
    "validation_error": null,
    "confidence": "High",
    "parsed": {
      "country_code": "US",
      "manufacturer_code": "TNP",
      "serial_number": "D7474",
      "production_month": "February",
      "production_year_short": "8",
      "model_year": "1999"
    }
  }
}

Technical Specs

  • Formats accepted: PNG, JPG, WEBP — optimized for dockside smartphone photos
  • Response time: typically under 1 second
  • Condition handling: robust against weathered fiberglass, painted engravings, and water glare
  • Algorithm checks: built-in Coast Guard validation to verify the 12-character standard format
  • Data extraction: isolates the HIN even when surrounded by hull textures or marine growth

Key Features

  • MIC Decoding: automatically identifies and extracts the 3-character Manufacturer Identity Code
  • Date Parsing: decodes the proprietary production month and model year logic built into the HIN
  • Format validation: verifies if the scanned code matches standard US, straight-year, or model-year formats
  • Edge computing ready: lightweight API payload designed for fast connectivity at marinas with poor cellular service

Live Demo: HIN OCR Scanner

No registration required. Upload a file to test the extraction.

1
Upload
2
Results

Drop files here or click to browse

JPG · PNG · WebP  ·  up to 500 files · max 4.5 MB each

No files selected

Frequently Asked Questions

Does StructOCR work inside a Bolt.new app?

Yes. StructOCR is a standard REST API that accepts a file and returns JSON — Bolt.new can call it directly from a client-side fetch in its in-browser WebContainer environment.

Where should I store the StructOCR API key in Bolt.new?

For testing within Bolt, you can create a `.env` file in the browser's file explorer and add `VITE_STRUCTOCR_KEY`. For production marine apps where you want to hide the API key, proxying through a secure backend is the recommended approach.

Can it read HINs that are painted over or engraved in fiberglass?

Yes. Our HIN model is specifically trained on real-world maritime conditions, including shallow gel-coat embossing, painted metal plates, and uneven surfaces.

Does the API tell me the manufacturer of the boat?

Yes. The API automatically parses the 12-character HIN to extract the Manufacturer Identity Code (MIC), as well as the production month and model year.

How can I test the accuracy before building?

You can verify the model live with your own boat transom photos using our free HIN scanner tool.

Is there a free tier to test with?

Yes. StructOCR's free plan includes 10 scans per month with no credit card required. Check out our pricing page for full details.

More Tutorials

Precise Data Extraction and Seamless Integration with AI-powered OCR API.

Empower your solutions with automated data extraction by integrating best-in class StructOCR via API seamlessly.

No credit card required • Full API access included