BigSky Planner iOS User Manual

Release: 1.3.1 (1)

Updated: 2026-05-30

Purpose

BigSky Planner for iPhone and iPad helps set up an observing location, choose telescope equipment and accessories, filter target catalogs, assign observation times, review weather and sky information, and export an observing plan.

First Start Setup

Screenshot: First start setup path (Screenshots/UserGuide/Level1/00-first-start-setup.png)

• On first launch, answer whether the app may use the internet for setup and user-started data updates.
• Open the Privacy Statement link before answering if you want to review how data is handled. The privacy review state is saved locally and shown again in Set Up.
• After Internet, Privacy, or Plan Save Folder are answered, their action controls dim so the completed setup items are clear. Use Clear and Start Over to reset first-start setup.
• The Finish card and Setup Checklist stay pinned at the top. Collapse Details hides the explanatory setup text while leaving the checklist tick marks visible.
• Choose a preferred language.
• Create a primary viewing location using GPS, address entry, or manual coordinates.
• Choose the primary telescope and any compatible accessories. After saving, the telescope card collapses to its summary and the setup flow moves to the plan folder step.
• Choose or create a plan save folder in Files. That folder becomes the default destination for saved plan files and PDFs when available.
• Finish setup when internet preference, privacy review, location, telescope, plan save folder setting, and language are set. You can finish later after answering the internet permission prompt.

Home

Screenshot: Home dashboard (Screenshots/UserGuide/Level1/01-home-iphone.png)

• Home is the main dashboard.
• Use the action buttons to open Locations, Telescope, Targets, Planner, Weather, Set Up, and Help.
• The top card accepts telescope initialize and stop tracking times. Time entry accepts HHMM, 12-hour text such as 8:30 PM, and 24-hour text such as 2030.
• Applying the telescope time window saves the observing window used by weather and target planning, then sends you to set or confirm a location.
• The top Home banner is compact so the actions and bottom data card remain visible on iPhone.
• The interface follows the iPhone or iPad system appearance automatically; the app no longer forces a dark-only help or shell view.
• The My Telescope card uses tighter padding so the lower information card stays readable.
• The taller bottom data card lists Location Name, Telescope With Accessories, Total Targets, and Chosen Hemisphere Targets in larger dark yellow text on the standard blue card background.

Locations

Screenshot: Observation locations (Screenshots/UserGuide/Level1/02-locations-top-level.png)

• Save at least one observing location before filtering targets or reading weather.
• Use GPS first when possible. After GPS fills the site, Address Info collapses automatically and can be expanded again.
• If you start a new location card, use Cancel to leave without saving it.
• Manual entry asks for Country first so address labels match the selected country.
• The page scrolls while editing so lower fields and saved locations remain reachable.
• Elevation is saved when GPS or manual entry provides it. Weather pressure is adjusted for the saved elevation when available.
• Only one location can be default at a time.
• Set Default promotes a saved location without re-entering the site details.
• Use Delete Location on a saved location card when a site should no longer be available.

Telescope

Screenshot: Smart telescope setup (Screenshots/UserGuide/Level1/03-telescope-top-level.png)

• Select the telescope you plan to use.
• Select compatible accessories for that telescope before saving the setup.
• Saved telescope and accessory data are used in Planner reports.
• The first saved or selected telescope can become the default telescope used by Home and Planner.

Targets

Screenshot: Target database filters (Screenshots/UserGuide/Level1/04-targets-top-level.png)

• Use Update Data when target sources need refreshing.
• Use the Current Setup card to expand or collapse the active target settings summary.
• Catalog, Time, and Filter cards open popups. Apply catalog, time, and filter changes from inside those popups before reviewing the target list.
• Action cards use glass status colors: green when a required setup block is valid, red until required user data is entered or the user has opened a filter without setting it.
• The top Apply action has been removed so Catalog and Current Setup have more room.
• Current target setup is held temporarily, so returning to Target Setup restores the active catalog, time, and filter choices.
• If transient target data is stale, target cards show Update Data and remain disabled until refreshed.
• Numeric altitude and azimuth entry supports the iOS numeric keypad. Dismiss the keypad before moving farther down the card.

Advanced Target Filters

Screenshot: Advanced target filters (Screenshots/UserGuide/Level2/01-targets-advanced-filters.png)

• Open Advanced Filters for magnitude, altitude, magnetic azimuth, object type, and observing-window limits.
• Altitude limits accept 0 through 99 degrees. Azimuth limits accept 000 through 360 degrees.
• Obstructions remove targets that fall inside blocked azimuth or altitude ranges.
• Clear Sky filter ranges can be added one after another without closing the card, and a new range can be canceled before saving.
• Returning to Advanced Filters activates Apply Filter even if values did not change, so you can rerun the current filter set.
• After applying filters, advanced options collapse and the target data is presented.

Target Results

Screenshot: Filtered target results (Screenshots/UserGuide/Level2/02-targets-filter-results.png)

• Target cards show object type, magnitude, first usable time, altitude, and azimuth.
• Use Add to Planner for a target that is not yet scheduled.
• Use Go to Planner for a target already added to the plan.
• Targets that fail obstruction, altitude, azimuth, magnitude, location, or time-window checks are removed from the candidate list.

Observation Time Sheet

Screenshot: Target observation time sheet (Screenshots/UserGuide/Level3/01-target-observation-time-sheet.png)

• Set the target start and stop time from the observation-time sheet.
• Start and stop values can be entered in 12-hour or 24-hour form.
• Times after midnight are normalized to the next calendar day of the same observing night.
• The app checks planned target windows and blocks true overlaps.
• If a time conflict is found, cancel or resolve the conflicting target before the new target is committed.

Planner

Screenshot: Planner (Screenshots/UserGuide/Level1/05-planner-top-level.png)

• The Planner page collects targets and observation windows into a plan.
• Sort the plan by Start Time, Zenith, or Magnitude as needed.
• Target cards scroll under the save and print options so the controls remain reachable.
• If no plan exists, the planner says no plan is currently built and links back to Plan an Observation.

Planner Actions

Screenshot: Planner actions (Screenshots/UserGuide/Level2/03-planner-actions.png)

• When a plan is present, Save PDF, Preview, Print Plan, Delete Plan, Load Plan, and Share Plan are available.
• Load Plan opens saved plans. After loading, the app shows Plan Loaded and asks whether to add more targets.
• Choose Yes to go to Targets. Choose No to stay on Planner.
• The loaded plan name and loaded-plan status text turn yellow so it is clear a saved plan is active.
• Printing uses a spreadsheet-style layout with Start, End, Alt, Az, and Mag.

Weather and Sky Info

Screenshot: Weather and sky info (Screenshots/UserGuide/Level1/07-weather-sky-info.png)

• Weather uses the default viewing location and telescope observing window when available.
• If My Telescope times are set, the viewing period follows that saved initialize/stop window until a saved plan takes over.
• The glass Date and Time Period Forecast card lists the active observing date and time range.
• The Sun/Moon glass card shows Sunset, Sunrise, Bortle/SQM, and time of total darkness based on the saved location.
• Bortle/SQM is estimated from the saved latitude, longitude, elevation, and nearby population light-pressure reference used by the app.
• The compact Source row names the weather source and includes Update to reload the hourly data.
• Hourly rows list time, icon, cloud percentage, rain chance, barometric pressure with trend arrow, temperature, and dew point.
• Night icons use crescent moon and cloud symbols. Daylight hours use sun and cloud symbols between sunrise and sunset.
• The Done action is kept above the menu bar on iPhone.
• If no valid location is saved, weather cannot calculate local conditions. Return to Locations and save a valid site.

Set Up

Screenshot: Set Up (Screenshots/UserGuide/Level1/08-set-up-top-level.png)

• Set Up contains language, unit preference, internet permission, data update actions, and About This App.
• Internet-required actions are labeled.
• Target and smart telescope database updates are user-started.
• Target Database Update summarizes changed transients, lists their names, and shows pulled-and-stored asteroid and comet names such as Ceres and Vesta.
• The app keeps data on the device. Internet access is used for updates and lookups, not remote storage of app data.
• About This App opens controlled in-app web windows for off-site privacy, support, and reference pages.

Help and Clock Support

Screenshot: Help (Screenshots/UserGuide/Level1/06-help-top-level.png)

• Open Help from the question mark icon in the bottom menu bar.
• Help mirrors the major manual sections with embedded screenshots.
• The help content includes first-, second-, and third-level flows.

Screenshot: Clock support detail (Screenshots/UserGuide/Level3/02-help-clock-support.png)

• Displayed times follow the iPhone or iPad clock preference.
• Time entry accepts common 12-hour and 24-hour formats.
• HHMM entry such as 2000 is accepted anywhere the app asks for telescope or observation times.

Appearance and Text Scaling

• Light and Dark appearance follow the system setting through UIUserInterfaceStyle = Automatic and SwiftUI colorScheme-aware styling.
• Standard SwiftUI text styles such as body, headline, subheadline, caption, and footnote participate in Apple text scaling automatically.
• Compact dashboard, tab, chart, and badge labels still use some fixed-size layout fonts so the interface can preserve dense observing data. These are the remaining candidates for a future Dynamic Type pass using relative fonts, @ScaledMetric, and larger-size layout testing.
• The app includes AppTextOverflowGuard for focused text-fit checks during development.

Troubleshooting

No Targets Appear

• Confirm a default location is saved.
• Confirm the telescope observing window is set if you are filtering by time.
• Set required red Catalog, Time, or Filter cards, then use Apply Filters inside the popup.
• Loosen magnitude, altitude, azimuth, and object-type settings.
• Check obstruction ranges. A target inside an obstruction range is intentionally removed.

Asteroids Or Comets Look Stale

• Run Target Database Update from Set Up.
• Review the update summary for Small bodies updated, Pulled and stored, and Changed transients.
• Stale transient target cards cannot be used until data is refreshed.

Weather Is Blank Or Wrong For The Site

• Save a valid default location first.
• Confirm latitude and longitude are present.
• Add elevation when available so pressure can be adjusted for the site.
• Confirm internet permission is enabled for weather prediction data.

Location Entry Will Not Save

• Enter a Location Name.
• Use GPS or enter latitude and longitude manually.
• If GPS was used, address fields are optional.
• If manual address is used, choose Country first so fields match the country format.

Numeric Keypad Covers The Target Card

• Dismiss the keypad after entering the value.
• Scroll the target page so cards pass under the filter panel.
• Reopen Advanced Filters only when more values must be changed.

Plan Load Is Confusing

• After loading a saved plan, watch for the Plan Loaded prompt.
• Choose Yes to add more targets.
• Choose No to return to Planner.
• Yellow plan name and yellow loaded-plan status text identify the active loaded plan.

Print Or PDF Does Not Appear

• Confirm at least one target is in the plan.
• Use Preview first to confirm the plan content.
• Confirm the default plan folder setting if you expect exported plans to appear in Files.
• Try Share Plan if the device print sheet is not available.

Code Annotations

• AstronomyObservationPlanningIOSApp owns the top-level launch gate: it records the first launch date, allows a 30-day test window, presents the friendly App Store purchase prompt after expiration, and then routes active users to privacy/first-start or the main shell.
• MobileShellView owns the iOS tab shell, system light/dark adaptation, compact Home header, Home settings data card, first-start setup, persisted internet/privacy setup status, pinned first-start Finish and Setup Checklist cards, in-app help content, and page routing.
• FirstStartSetupView owns dimmed completed setup actions, collapsible setup checklist details, primary location auto-scroll, telescope-card collapse after save, and plan-folder completion state.
• ObservationLocationEditorCard owns location name, GPS, country-first address entry, optional address labels after GPS, elevation, save, Set Default, Delete Location, and default-location behavior.
• TargetDatabaseScreen owns the two-control Target Setup top row, catalog scope, My Telescope observing-window defaults, filters, advanced filters, obstruction filtering, target cards, and Add to Planner routing.
• TargetDatabaseHeaderView owns the Catalog, Time, and Filter popup action cards, including per-popup Apply and Cancel behavior.
• ObservationPlannerScreen owns loaded-plan prompts, highlighted loaded-plan status, spreadsheet-style PDF/print rows, Preview PDF, Save PDF, Print Plan, Delete Plan, Share Plan, sort, and plan load/save behavior.
• PlanSaveFolderPreferenceStorage owns the default Files folder bookmark used when saving plan text files and PDFs, with share-sheet fallback when a folder is not available.
• WeatherAndSkyInfoScreen owns the viewing-period, My Telescope fallback window, sun/moon, compact source/update header, hourly weather rows, pressure trend, elevation-adjusted pressure, unit preference, and location-dependent weather display.
• MobileHelpSheet mirrors this manual at a shorter in-app level, includes appearance/text-scaling notes, and loads screenshots from Sources/Core/Resources/HelpScreenshots.
• MobileGlassTabBarBackground and MobileMenuBarStyle own the adaptive bottom tab material, selected/unselected icon colors, and light/dark glass treatments.
• AppTextOverflowGuard provides development-time text overflow checks for high-risk compact labels.

Logic Flow Export

The full multi-page logic flow is exported as:

• Documentation/iOS-Logic-Flow-Overview.html
• Documentation/iOS-Logic-Flow-Overview.pdf