hint-lang-cli

The easiest way to build fullstack applications with Hint Language.

🚀 Quick Start

# Install CLI (one-time)
npm install -g hint-lang-cli

# Create project
hint create my-app

# Start developing
cd my-app
hint dev

That's it. The compiler downloads automatically. No Rust. No PATH configuration.

✨ Features

• 🎯 Zero Setup - Compiler auto-downloads on first run
• 🔥 Hot Reload - Edit .ht files, browser updates instantly
• 📦 Templates - Start with website, electron, fullstack, and more
• 🌐 Fullstack - Frontend (WASM) + Backend (Native) in one language
• 🚀 Production Ready - Build and deploy anywhere

📖 Commands

Create Project

# Create with default template (website)
hint create my-app

# Choose template
hint create my-app --template electron
hint create my-app --template fullstack
hint create my-app --template tauri

Development

# Start dev server
hint dev

# Custom port
hint dev --port 8080

# Don't open browser
hint dev --no-open

Build

# Build for production
hint build

# Custom target
hint build --target wasm32
hint build --target native

# Custom output
hint build --output build

Serve

# Serve production build
hint serve

# Custom port
hint serve --port 8080

Compiler Management

# Install/update compiler
hint compiler install

# Check version
hint compiler version

📁 Project Structure

my-app/
├── .hint/
│   └── compiler/          # Auto-downloaded compiler
├── src/
│   ├── main.ht            # Entry point
│   ├── pages/
│   │   └── index.ht       # Pages
│   ├── components/        # Reusable components
│   └── api/               # Backend API (fullstack)
├── public/                # Static assets
├── dist/                  # Build output
├── hint.config.json       # Hint config
└── package.json           # Node dependencies

⚙️ Configuration

hint.config.json

{
  "target": "wasm32",
  "entry": "src/main.ht",
  "output": "dist/app.wasm",
  "devServer": {
    "port": 3000,
    "open": true
  },
  "build": {
    "optimize": true,
    "sourceMap": false
  }
}

package.json

{
  "scripts": {
    "dev": "hint dev",
    "build": "hint build",
    "start": "hint serve"
  },
  "hintc": {
    "version": "0.2.0",
    "autoDownload": true
  }
}

🎨 Templates

website (default)

Pure Hint website with WASM frontend.

hint create my-app --template website

fullstack

Frontend + Backend + Database in pure Hint.

hint create my-app --template fullstack

electron

Desktop app with Electron.

hint create my-app --template electron

tauri

Lightweight desktop app with Tauri.

hint create my-app --template tauri

🛠 Environment

Requirements

• Node.js 16+ (for CLI)
• Any modern browser (for running apps)

Supported Platforms

| Platform | Status | |----------|--------| | Windows x64 | ✅ | | macOS x64 | ✅ | | macOS ARM (M1/M2) | ✅ | | Linux x64 | ✅ |

📚 Documentation

• Hint Language Docs
• Syntax Guide
• Examples

🤝 Contributing

# Clone repo
git clone https://github.com/hint-lang/hintc.git

# Install dependencies
cd packages/cli
npm install

# Link locally
npm link

# Test
hint --version

📄 License

MIT License - See LICENSE for details.

Built with ❤️ using Hint Language