# Create new project
./ftc-new-project my-robot

# Upgrade existing project
./ftc-new-project my-robot --upgrade

# Enter and test
cd my-robot
./gradlew test --continuous

Windows

REM Create new project
ftc-new-project.bat my-robot

REM Upgrade existing project
ftc-new-project.bat my-robot --upgrade

REM Enter and test
cd my-robot
gradlew test --continuous

Installation

Linux/macOS

# Option 1: Add to PATH
echo 'export PATH=$PATH:/path/to/ftc-project-gen' >> ~/.bashrc
source ~/.bashrc

# Option 2: Symlink
sudo ln -s /path/to/ftc-project-gen/ftc-new-project /usr/local/bin/

# Option 3: Use directly
./ftc-new-project my-robot

Windows

REM Add directory to PATH or use directly
ftc-new-project.bat my-robot

Project Structure

ftc-project-gen-1.0.0-beta/
├── ftc-new-project              # Linux main script
├── ftc-new-project.bat          # Windows main script
├── linux/                       # Linux-specific support files
│   ├── templates/              # File templates
│   │   ├── Pose2d.java
│   │   ├── Drive.java
│   │   ├── DriveTest.java
│   │   ├── MecanumDrive.java
│   │   ├── TeleOp.java
│   │   ├── build.gradle.kts
│   │   ├── settings.gradle.kts.template
│   │   ├── gitignore.template
│   │   ├── README.md.template
│   │   ├── build.sh
│   │   └── deploy-to-robot.sh
│   └── lib.sh                  # Shared functions
├── windows/                    # Windows-specific support files
│   ├── templates/              # File templates
│   │   └── (mirrors linux templates)
│   └── lib.bat                 # Shared functions
├── tests/                      # Test suite
│   ├── unit/                   # Unit tests
│   └── system/                 # System/integration tests
├── VERSION                     # Version file
└── README.md

Development

Running Tests

# Run all tests
./tests/run-tests.sh

# Run specific test suite
./tests/run-tests.sh unit
./tests/run-tests.sh system

# Run specific test
./tests/run-tests.sh unit test_template_rendering

Testing Philosophy

Unit tests: Test individual functions and template rendering
System tests: Test end-to-end project creation, building, and upgrading
Regression tests: Ensure generated projects build and pass their own tests

Upgrading

What Gets Updated

When you run with --upgrade:

✓ Build configuration files (build.gradle.kts, settings.gradle.kts)
✓ Helper scripts (build.sh, deploy-to-robot.sh)
✓ .gitignore
✗ Your source code (never touched)
✗ Your tests (never touched)

Upgrade Process

# Backup recommended but not required (git protects you)
cd my-robot
git status  # Make sure you've committed your work

# Run upgrade
ftc-new-project my-robot --upgrade

# Review changes
git diff

# Test
./gradlew test

Architecture

Template System

Files are stored as templates in templates/ directories. Templates can contain placeholders:

{{PROJECT_NAME}} - Replaced with project name
{{SDK_DIR}} - Replaced with SDK directory path
{{FTC_VERSION}} - Replaced with FTC SDK version

Upgrade System

Projects track their generator version in .ftc-generator-version. During upgrade:

Check if project exists
Verify it's a generator project
Update only infrastructure files
Preserve user code
Update version marker

Cross-Platform Support

Linux: Bash scripts with POSIX compliance
Windows: Batch scripts with delayed expansion
Shared logic where possible
Platform-specific implementations in separate directories

Contributing

Adding New Templates

Create template file in linux/templates/ and windows/templates/
Use placeholders for variable content
Update lib.sh/lib.bat to include new template
Add tests for the new template
Update documentation

Running Tests Before Commit

./tests/run-tests.sh

All tests must pass before submitting changes.

License

MIT License - See individual project files for details.