• v1.0.0 6b6ba058b7

    eric released this 2026-01-27 01:39:34 +00:00 | 22 commits to master since this release

    Weevil has reached 1.0.0! This is the first production-ready stable release.

    After extensive testing on Windows, Linux, and macOS, Weevil is ready for FTC teams to use in production. This release provides a robust, cross-platform project generator that separates team code from the FTC SDK, enables local testing, and simplifies the build/deployment workflow.

    What is Weevil?

    Weevil generates standalone FTC robot projects that:

    • Keep your code separate from the SDK
    • Support local unit testing (no robot needed!)
    • Work with multiple SDK versions simultaneously
    • Generate all build/deploy scripts automatically
    • Enable proper version control workflows

    In short: Students focus on building robots, not navigating SDK internals.

    Highlights of 1.0.0

    Complete Windows Support

    • Fully tested Windows deployment pipeline
    • Robust batch file path parsing
    • Correct APK discovery and installation
    • Proper ADB integration with error reporting

    Cross-Platform Build System

    • Single command builds on Windows, Linux, and macOS
    • Automatic Gradle wrapper configuration
    • Smart SDK path resolution
    • Platform-specific scripts generated automatically

    Project Management

    • Per-project SDK configuration via .weevil.toml
    • weevil upgrade command to update infrastructure
    • Config migration for legacy projects
    • SDK version tracking

    Developer Experience

    • Local unit testing with JUnit 5
    • Git initialization with proper .gitignore
    • Clean project structure following industry standards
    • Comprehensive error messages and diagnostics

    Quick Start

    # Create a new robot project
    weevil new my-robot
    
    # Test locally (no robot needed!)
    cd my-robot
    ./gradlew test
    
    # Build and deploy
    ./build.sh    # or build.bat on Windows
    ./deploy.sh   # or deploy.bat on Windows
    

    Installation

    Download the appropriate binary for your platform from the assets below, or build from source:

    git clone https://www.nxgit.dev/nexus-workshops/weevil.git
    cd weevil
    cargo build --release
    

    See the README for detailed installation instructions and prerequisites.

    What's Next?

    See ROADMAP.md for planned post-1.0.0 features including:

    • Custom project templates
    • FTC library package management
    • IDE integration
    • Multi-robot workspace support
    • CI/CD pipeline generation

    Stability Commitment

    As a 1.0.0 release, Weevil commits to:

    • Semantic versioning for all future releases
    • Backward compatibility for project configs
    • Migration paths for breaking changes
    • Stable CLI interface

    Known Issues

    None at this time. Please report any issues on our issue tracker.

    Acknowledgments

    Thanks to all the FTC teams and mentors who provided feedback during the RC phase. Your testing and patience made this release possible.

    Built with ❤️ for FIRST Tech Challenge teams everywhere.


    Full Changelog: v1.0.0-rc2...v1.0.0

    📧 Questions? eric@nxlearn.net
    🐛 Issues? Open an issue

    Building better tools so you can build better robots. 🤖

    Downloads