██████╗ ██████╗ █████╗ ██████╗██╗ ██╗██╗ █████╗ ██████╗
██╔═══██╗██╔══██╗██╔══██╗██╔════╝██║ ██║██║ ██╔══██╗██╔══██╗
██║ ██║██████╔╝███████║██║ ██║ ██║██║ ███████║██████╔╝
██║ ██║██╔══██╗██╔══██║██║ ██║ ██║██║ ██╔══██║██╔══██╗
╚██████╔╝██║ ██║██║ ██║╚██████╗╚██████╔╝███████╗██║ ██║██║ ██║
╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝
Project scaffolding and script runner for Arcane-based Flutter and Dart applications.
- Project Scaffolding - Create production-ready Flutter and Dart projects
- Script Runner - Execute pubspec.yaml scripts with fuzzy matching
- Multi-Project Architecture - Client, models, and server packages
- Firebase Integration - Automated setup and deployment
- Platform Selection - Choose which platforms to target
Oracular/
├── oracular/ Dart CLI tool
├── docs/ Documentation and guides
└── templates/ Project templates (editable)
├── arcane_app/ Basic multi-platform Flutter app
├── arcane_beamer_app/ Beamer navigation Flutter app
├── arcane_dock_app/ Desktop system tray app
├── arcane_jaspr_app/ Jaspr web application
├── arcane_jaspr_docs/ Jaspr static documentation site
├── arcane_cli_app/ Dart CLI application
├── arcane_models/ Shared data models package
└── arcane_server/ Shelf-based REST API server
dart pub global activate oracular# Interactive wizard
oracular
# Create project directly
oracular create app --name my_app --org com.exampleoracular # Interactive wizard
oracular create app # Create project with prompts
oracular create templates # List available templatesRun scripts defined in your pubspec.yaml:
oracular scripts list # List all scripts
oracular scripts exec build # Run a script
oracular scripts exec br # Abbreviation (build_runner)
oracular scripts exec tv # Abbreviation (test_verbose)Supports fuzzy matching and abbreviations (first letter of each word).
oracular check tools # Verify all CLI tools
oracular check flutter # Check Flutter installation
oracular check firebase # Check Firebase CLI
oracular check docker # Check Docker
oracular check gcloud # Check Google Cloud SDK
oracular check doctor # Run flutter doctororacular deploy all # Deploy all Firebase resources
oracular deploy firestore # Deploy Firestore rules
oracular deploy storage # Deploy Storage rules
oracular deploy hosting # Deploy to release hosting
oracular deploy hosting-beta # Deploy to beta hosting
oracular deploy firebase-setup # Initial Firebase setuporacular deploy server-setup # Generate Docker configs
oracular deploy server-build # Build Docker image| Template | Platforms | Description |
|---|---|---|
| Basic Arcane | All | Multi-platform app with Arcane UI |
| Beamer Navigation | All | Declarative routing with Beamer |
| Desktop Tray | Desktop | System tray/menu bar application |
| Template | Output | Description |
|---|---|---|
| Jaspr Web App | SPA | Interactive web application with Arcane Jaspr |
| Jaspr Docs | Static | Documentation site with markdown support |
| Template | Description |
|---|---|
| Dart CLI | Command-line interface application |
- Models Package - Shared data models for client and server
- Server App - Shelf-based REST API with Firebase integration
Not sure which platform to use? See our comprehensive Platform Comparison Guide for detailed pros/cons analysis.
Quick Decision:
- Need native mobile/desktop apps? Use Flutter + Arcane
- Building a website with SEO requirements? Use Jaspr + Arcane Jaspr
- Want fast initial page loads? Use Jaspr + Arcane Jaspr
- Need offline-first functionality? Use Flutter + Arcane
Add scripts to your pubspec.yaml:
scripts:
build: flutter build web --release
deploy: firebase deploy --project my-project
build_runner: dart run build_runner build --delete-conflicting-outputs
test_verbose: dart test --reporter=expanded
pod_install: cd ios && pod install --repo-updateThen run with abbreviations:
oracular scripts exec b # build (unique prefix)
oracular scripts exec br # build_runner
oracular scripts exec tv # test_verbose
oracular scripts exec pi # pod_installSee the CLI Development README.
MIT