npm package: @isthatuzii/create-nanoframework-app
Description: Desktop application scaffolding tool for the Nano Framework
Author: Imperium Industries
Latest version: 1.2.4

# @isthatuzii/create-nanoframework-app

Professional desktop application scaffolding tool for the Nano Framework.

**Built by [Imperium Industries](https://imperium-industries.dev) | Powered by Microcode Labs**

## Usage

```bash
# With npm
npm create @isthatuzii/nanoframework-app@latest my-app

# With yarn
yarn create @isthatuzii/nanoframework-app my-app

# With pnpm  
pnpm create @isthatuzii/nanoframework-app my-app

# With bun
bun create @isthatuzii/nanoframework-app my-app

# Alternative: using npx directly
npx @isthatuzii/create-nanoframework-app my-app
```

## ✨ Enhanced Experience

Our professional CLI provides an interactive setup with:

1. **🎨 Animated Startup**: Beautiful ASCII art and company branding
2. **🏗️ Framework Choice**: SolidJS, React, or Vue with optimized configurations
3. **📦 Package Manager**: Support for npm, yarn, pnpm, and bun
4. **🔄 Git Integration**: Auto-initialize repository with professional commit messages
5. **💻 VS Code Setup**: Workspace configuration with Rust and frontend extensions
6. **🔧 cargo-watch**: Automatic installation for hot reload development
7. **🏥 Health Checks**: Post-creation validation and diagnostics
8. **📋 Template UI**: Optional comprehensive UI component library

## Supported Frameworks

- **SolidJS** - Fine-grained reactive UI library
- **React** - Popular UI library with hooks
- **Vue** - Progressive JavaScript framework

## Features

- 🚀 **Desktop Applications** - Native desktop apps with Rust backend
- ⚡ **Hot Reload** - Fast development with Vite + Cargo watch
- 📦 **Portable Builds** - Single executable with embedded assets
- 🎨 **VS Code Theme** - Professional dark theme
- 🔧 **Configurable** - Window properties, server settings via JSON
- 🌐 **HTTP API** - RESTful API with Axum backend
- 🎯 **TypeScript Ready** - Full TypeScript support

## Project Structure

```
my-app/
├── src-nano/           # Rust backend
│   ├── main.rs         # Entry point
│   ├── server.rs       # HTTP server
│   └── modules/        # API modules
├── src/                # Frontend source
├── nano.config.json    # App configuration
├── Cargo.toml          # Rust dependencies
└── package.json        # Node dependencies
```

## Development Commands

```bash
# Start development with hot reload
npm run nano:hot

# Build and run
npm run nano

# Build portable release
npm run nano:release
```

## Requirements

- [Rust](https://rustup.rs/) (latest stable)
- [Node.js](https://nodejs.org/) 18+
- Your chosen package manager

## Documentation & Support

- **Framework Docs**: https://nano-framework.dev
- **Issues & Bug Reports**: https://github.com/imperium-industries/create-nano-app/issues
- **Email Support**: uziidevelopment@gmail.com
- **Company Website**: https://imperium-industries.dev

## License

MIT © 2024 Imperium Industries

---

*Built with precision and care by **Imperium Industries** | **Microcode Labs***  
*Professional development tools for modern applications*