{'Repository Setup': [{'Clone repo': 'git clone https://github.com/flet-dev/flet'}], 'Python SDK': [{'Install uv': {'Windows': 'powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"', 'macOS/Linux': 'curl -LsSf https://astral.sh/uv/install.sh | sh', 'Windows PATH': 'Add %USERPROFILE%\\AppData\\Roaming\\Python\\Scripts to PATH'}}, {'Open worker directory': 'cd sdk/python'}, {'Install dependencies': 'uv sync'}, {'Check the installation': ['Create hello.py with a minimal Flet program.', 'Run with uv run python hello.py.', 'Flet Client downloads automatically from GitHub releases.', 'Expected output: Native OS window with "Hello, world!".']}, {'Running tests': 'uv run pytest'}, {'Code formatting': ['Uses Black formatting style.', 'VS Code extension: ms-python.black-formatter.', 'IDE-specific guides available.']}, {'Type checking': 'Enable Pylance _basic_ type checking mode in VS Code.'}, {'Sort imports on Save': 'Install ms-python.isort VS Code extension.'}, {'pre-commit': ['Installed by uv sync.', 'Install hooks: uv run pre-commit install.', 'Hooks run automatically on commit.']}], 'Flutter Client': [{'Environment Variables': [{'macOS/Linux': ['Add to ~/.zprofile or similar:', 'export FLET_VIEW_PATH="$HOME/{path-to-flet}/flet/client/build/macos/Build/Products/Release"', 'export FLET_WEB_PATH="$HOME/{path-to-flet}/flet/client/build/web"']}, {'Windows': ['Add to System Properties > Environment Variables:', 'Variable: FLET_VIEW_PATH, Value: {path-to-flet}\\flet\\client\\build\\windows\\x64\\runner\\Release', 'Variable: FLET_WEB_PATH, Value: {path-to-flet}\\flet\\client\\build\\web']}, {'Linux': ['Add to ~/.bash_profile or similar:', 'export FLET_VIEW_PATH="$HOME/{path-to-flet}/flet/client/build/linux/{arch}/release/bundle"', 'export FLET_WEB_PATH="$HOME/{path-to-flet}/flet/client/build/web"']}]}, {'Debugging with Microsoft Edge': 'Set CHROME_EXECUTABLE="/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge"'}, {'Building the Flutter client': ['Open flet-dev/flet/client in IDE (e.g., VS Code).', 'Verify environment variables using printenv | grep FLET.', 'Build for macOS: flutter build macos (output in FLET_VIEW_PATH).', 'Build for Web: flutter build web (output in client/build/web).']}, {'Running the Flutter client': ['Open flet-dev/flet/sdk/python in a new VS Code instance.', 'Create a playground folder.', 'Run Python client: uv run flet run -w -p 8550 playground/.', 'Opens http://127.0.0.1:8550/ and a desktop window.', 'Hot reload on Python changes.', 'In Flutter VS Code instance, run flutter run to start/connect Flet client.', 'Debugging output visible in Flutter client terminal.']}, {'Restarting/Rebuilding': ['Dart changes: Restart/rerun Flutter client (R key or flutter run).', 'Python changes: Rerun Python client command: uv run flet run -w -p 8550 playground/.']}], 'Releasing Flet': ['Create prepare-{version} branch in flet-dev/flet.', 'For each package in packages/flet*:', ' Update version in pubspec.yaml.', ' Add version entry to CHANGELOG.md.', 'Copy packages/flet/CHANGELOG.md section to root CHANGELOG.md.', 'Run flutter pub get in client directory.', 'Create {version} branch in flet-dev/flet-app-templates.', 'Create {version} branch in flet-dev/flet-build-template.', 'Create Prepare Flet {version} PR to merge into main.', 'Verify Flet CI build analysis report.', 'Merge PR.', 'Create and push v{version} tag.', 'Update release notes at https://github.com/flet-dev/flet/releases/tag/v{version}.'], 'New macOS Environment Setup': [{'Homebrew': ['Install: ', 'Install xz: brew install xz']}, {'Pyenv': ['Install: brew install pyenv.', 'Install Python 3.12.6: pyenv install 3.12.6.', 'Set global version: pyenv global 3.12.6.', 'Configure shell environment: Add to ~/.zprofile.', 'Verify installation: python --version, which python.']}, {'Rbenv': ['Install: brew install rbenv.', 'Install Ruby 3.3.5: rbenv install 3.3.5.', 'Set global version: rbenv global 3.3.5.', 'Verify installation: ruby --version, which ruby.']}, {'VS Code': "Install 'Apple silicon' release: "}, {'GitHub Desktop': 'Install Rosetta: '}, {'uv': ['Installation: ', "Set PATH: echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.zprofile.", 'Verify: uv --version.']}, {'Android Studio': 'Required for Android SDK: '}, {'XCode': 'Required for macOS and iOS SDKs: '}, {'FVM (Flutter Version Manager)': ['Installation: ', 'Install Flutter 3.24.3: fvm install 3.24.3.', 'Set global version: fvm global 3.24.3.', "Set PATH: echo 'export PATH=$HOME/fvm/default/bin:$PATH' >> ~/.zprofile."]}, {'Cocoapods': ''}]}