xcargo 0.1.0

Cross-compilation, zero friction - Rust cross-compilation tool with automatic toolchain management
Documentation
## 📁 **Complete Directory Structure**

```bash
apex/
├── .gitignore
├── Cargo.toml
├── LICENSE-MIT
├── LICENSE-APACHE
├── README.md
├── TARGETS.md
├── CONTRIBUTING.md
├── apex.toml.example
├── CHANGELOG.md (to be created)
├── src/
│   ├── lib.rs
│   ├── main.rs
│   ├── target/
│   │   └── mod.rs (to be created)
│   ├── toolchain/
│   │   └── mod.rs (to be created)
│   ├── build/
│   │   └── mod.rs (to be created)
│   ├── container/
│   │   └── mod.rs (to be created)
│   ├── config/
│   │   └── mod.rs (to be created)
│   ├── deps/
│   │   └── mod.rs (to be created)
│   └── output/
│       └── mod.rs (to be created)
├── examples/
│   └── basic_build.rs
├── tests/
│   └── integration.rs (to be created)
└── docs/
    ├── guide.md (to be created)
    └── targets.md (to be created)
```

## 🚀 Quick Start Commands

```bash
# Create project
cargo new apex
cd apex

# Copy all files above

# Build
cargo build

# Run CLI
cargo run -- --help

# Output:
# apex - Reach the apex of cross-compilation 🎯
# 
# Usage: apex [OPTIONS] <COMMAND>
# 
# Commands:
#   init    Initialize cross-compilation for current project
#   target  Add a target platform
#   build   Build for target(s)
#   doctor  Check system for missing dependencies
#   cargo   Run cargo command with apex wrapper
#   config  Show configuration
#   help    Print this message or the help of the given subcommand(s)

# Test
cargo test

# Example usage
cargo run -- init
cargo run -- target list
cargo run -- build --target windows
```

## 📋 Next Steps Checklist

Phase 1: Core
- [ ] Implement target detection
- [ ] Parse Cargo.toml for targets
- [ ] Detect installed toolchains (rustup)
- [ ] Basic native build wrapper

Phase 2: Toolchain
- [ ] Auto-install Rust targets
- [ ] Detect system linkers
- [ ] Suggest missing tools
- [ ] Installation helpers

Phase 3: Container
- [ ] Youki integration (basic)
- [ ] Docker/Podman fallback
- [ ] Image management
- [ ] Build in container

Phase 4: Polish
- [ ] Configuration file handling
- [ ] Better error messages
- [ ] Progress indicators
- [ ] Documentation