Introduction

PortfolioApp is your all‑in‑one iOS, iPadOS, and macOS portfolio showcase. Whether you’re highlighting projects, sharing your bio, scheduling calls, or letting clients get in touch, PortfolioApp makes it intuitive—just like a traditional portfolio, but built for the future.

System Requirements

  • iOS 16.0+ / iPadOS 16.0+ / macOS 12.0+

  • Device: iPhone, iPad, or Mac with Apple Silicon or Intel

  • Storage: ~50 MB free space

  • Internet: Required for email sending, scheduling, and web content

Installation & Updates

  1. Download: Available on the Apple App Store or via TestFlight (beta). Android coming soon.

  2. First Launch: You’ll see the Home page, and can dive right in.

  3. Updates: Keep automatic updates enabled in your device’s Settings → App Store to get the latest features and fixes.

First‑Run Walkthrough (Coming soon)

On initial launch, the app will walk you through:

  1. Home Overview – Navigate key sections.

  2. Notifications – Opt in to reminders or announcements.

  3. Email & Scheduling – Quick demo of sending a message or booking time.

If you ever want to replay the walkthrough:

  • Go to Settings → Help & Feedback → Replay Walkthrough.

Core Features

1. Home

  • Dashboard: Quick links to About, Services, Scheduler, and Contact.

  • Latest Updates: Highlights from your What’s New splash. (Coming Soon)

2. About

  • Bio & Background: A detailed look at my skills, experience, and values.

  • Download Resume: Tap the “Download” icon to save a PDF version. (Coming Soon)

  • Schedule: Go directly to the scheduler.

3. Services

  • Service List: Browse offerings with icons and short descriptions.

  • Deep Dive: Tap “Learn More” under any service for an extended write‑up, testimonials, and “Schedule Now.”

4. Scheduler

  • Real‑Time Availability: View open slots and book instantly.

  • Confirmation: Receive an in-app confirmation and an email summary.

  • Rescheduling/Cancellation: Manage appointments right from the services tab or via email.

5. Contact

  • Send Email: Opens a pre‑filled message in your Mail app; tap Send Email to dispatch.

  • Social Links: Direct buttons for LinkedIn, GitHub, Twitter, etc., with haptic “tap” feedback. (Coming Soon)

Permissions & Privacy

  • Location Services: Used solely to show local time, availability, and map placement.

  • Email Access: PortfolioApp uses MessageUI; no data leaves your device unencrypted.

  • Web Content: Any external page (e.g., Portfolio websites) loads in-app via WebKit—no tracking.

Troubleshooting & FAQs

Issue Possible Cause Solution

Issue: App crashes on launch Possible Cause: Corrupted install Solution: Delete & reinstall the app from the App Store or TestFlight.

Issue: “HomeView not found” error Possible Cause: Outdated build Solution: Ensure you’re on the latest TestFlight build; contact support if it persists.

Issue: Email won’t send Possible Cause: Mail app not configured Solution: Verify your default Mail account in Settings → Mail; try again.

Issue: Cannot schedule appointment Possible Cause: No internet or permissions denied Solution: Check network connection.

FAQs

Contact & Support

If you can’t resolve an issue above:

  • Email Support: hello@szymonstephansikora.com

  • Live Chat: Tap the chat icon in the Contact tab (online weekdays 9 a.m.–5 p.m. ET) (Coming Soon)

  • Knowledge Base: (Coming Soon)

Version History & What’s New

  • What’s on the Home screen?

    Your dashboard shows four big buttons - About, Services, Scheduler, and Contact - plus a “What’s New” banner after each update.

    It’s designed to give you quick access to everything my app offers.

    1. Taps not working?

      • Try a firmer tap: I’ve added a light haptic “click” when you press.

      • Blank overlay after updating? Go to Settings → Cache → Clear Cache, then restart the app.

    2. Still stuck? Check you’re on the latest App Store or TestFlight version.

  • Pull down anywhere on a featured project to force a refresh (you’ll feel a slight haptic pulse). That re‑queries the server and updates availability, “What’s New,” and any dynamic content.

    1. Fully booked: I may be booked or unable to accommodate the requested time.

    2. Offline: Scheduler needs internet - if you’re offline it may not load properly.

  • For pricing, check the scheduler or reach out to me at hello@szymonstephansikora.com. Thank you!

    • Download settings: On your device go to Settings → Safari → Downloads and pick “On My iPhone/iPad.”

      • Low storage: If you have under 10 MB free, clear out some space.

  • It takes you straight to the Scheduler, with that service pre‑selected. Pick your time slot, confirm, and you’ll see it in the app and get a confirmation email from Acuity Scheduling.

    1. Fully booked: I may be booked or unable to accommodate the requested time.

    2. Offline: Scheduler needs internet - if you’re offline it may not load properly.

  • Spam folder: Look for mail from no-reply@acuityscheduling.com.

    Mail settings: Verify your default Mail account in Settings → Mail → Accounts.

  • Pull down anywhere on a featured project to force a refresh (you’ll feel a slight haptic pulse). That re‑queries the server and updates availability, “What’s New,” and any dynamic content.

  • New Features

    • Settings Tab

      • Clear Cache: Purge all WebKit data with one tap (with confirmation alert).

      • Report Feedback: Opens mail composer pre‑addressed to support inbox.

    • Pull‑to‑Refresh on Featured Projects

      • Featured Projects using embedded WebViews now support pull‑to‑refresh (with light haptic feedback).

      • Peek and Pop added to each project on Home Screen.

    • Location Manager Stub

      • Background plumbing in place for future location‑based features.

    • Services Page Refinements

      • Dark‑blue gradient and layout tweaks for each card.

      • Fully formatted detail pages for Web Design, IT Services, and Marketing & Social Media, each with consistent “Learn More” buttons.

      • “Book Now' buttons under each service.

    • Haptic Feedback

      • Light tap feedback on key actions (Send Email, Schedule Now, card previews).

    Performance Improvements

    • Pre‑load and cache hero images for near zero‑delay rendering.

    • Reduced memory overhead when scrolling long content lists.

    • Smoother, GPU‑accelerated animations on hero image, tab transitions, and service‑card reveals.

    • Faster WebView load times (improved request queuing).

    Bug Fixes

    • Contact form no longer crashes on large attachments or rejects valid inputs.

    • Dark Mode state now truly sticks after quitting and relaunching.

    • WebView refresh control correctly ends refreshing after load.

    • Context‑menu preview consistently triggers light haptic.

    • Cache clearing alert reliably appears once data removal completes.

  • Performance Improvements

    • What changed: Optimizations have been made to enhance the application’s performance.

    • Reduced load times across various sections.

    • Smoother transitions and animations.

    • Updated animations for Services pages

    • Formatted each Learn More page for Web Design, IT Services, and Marketing and Social Media pages under Services.

    • Why you’ll appreciate it: Delivers a more responsive and enjoyable user experience.

    Bug Fixes

    • Resolved: An issue where the contact form would occasionally fail to submit.

    • Resolved: Inconsistencies in the display of project images on certain devices.

    • Resolved: The Dark Mode toggle in “Settings” not retaining user preference after app restart.

    What to Test

    Navigation Bar

    • Verify that tapping on these icons leads to their respective sections without issues.

    Performance

    • Navigate through different sections of the app to observe load times and transition smoothness.

    • Report any noticeable delays or stutters.

    General Stability

    • Use the app extensively to identify any crashes or unexpected behaviors.

    • Pay special attention to the areas that have undergone recent changes.

  • Enhanced Navigation Bar

    • What changed: The bottom navigation bar has been refined for improved usability.

    • The “More” tab has been removed.

    • “Contact” and “Settings” are now accessible directly from the main navigation bar.

    • Why you’ll appreciate it: Provides quicker access to essential features without the need to navigate through additional menus.

    Projects Section Overhaul

    • What changed: The “Featured Projects” section has been restructured.

    • Projects are now displayed in a grid layout with thumbnail images.

    • Clicking on a project opens a detailed view with expanded images and comprehensive descriptions.

    • Why you’ll appreciate it: Enhances visual engagement and allows for more efficient browsing of projects.

    Introduction of Light Mode

    • What changed: A new Light Mode has been introduced.

    • Users can toggle between Dark Mode and Light Mode in the “Settings” section.

    • Why you’ll appreciate it: Offers flexibility to choose the preferred visual theme, catering to different lighting conditions and personal preferences.

    Performance Improvements

    • What changed: Optimizations have been made to enhance the application’s performance.

    • Reduced load times across various sections.

    • Smoother transitions and animations.

    • Why you’ll appreciate it: Delivers a more responsive and enjoyable user experience.

    Bug Fixes

    • Resolved: An issue where the contact form would occasionally fail to submit.

    • Resolved: Inconsistencies in the display of project images on certain devices.

    • Resolved: The Dark Mode toggle in “Settings” not retaining user preference after app restart.

    What to Test

    Navigation Bar

    • Ensure that “Contact” and “Settings” are accessible directly from the main navigation bar.

    • Verify that tapping on these icons leads to their respective sections without issues.

    Projects Section

    • Navigate to the “Featured Projects” section and confirm the grid layout displays correctly.

    • Click on various projects to ensure that detailed views load with expanded images and full descriptions.

    Light Mode

    • Go to “Settings” and toggle between Dark Mode and Light Mode.

    • Confirm that the theme changes immediately and persists after restarting the application.

    Performance

    • Navigate through different sections of the app to observe load times and transition smoothness.

    • Report any noticeable delays or stutters.

    General Stability

    • Use the app extensively to identify any crashes or unexpected behaviors.

    • Pay special attention to the areas that have undergone recent changes.

  • New “More” Tab

    • What changed: Contact and Settings are now together under a single More tab instead of separate icons.

    • Why you’ll love it: Cleaner bottom‑nav, easier to find “less‑used” options.

    Featured Projects Redesign

    • What changed: Each project is now a full‑width vertical card with a big image on top and title + description below.

    • Why you’ll love it: More visual impact, better use of your screen real‑estate.

    Hero Header Simplified

    • What changed: We removed the autoplay video and went back to a static “heroImage” with a “Welcome” overlay.

    • Why you’ll love it: Faster load times, no unexpected autoplay, consistent experience.

    Dark Blue → Black Gradient on Services

    • What changed: Services cards now sport a richer dark‑blue to black gradient background.

    • Why you’ll love it: Stronger contrast and a sleeker, more professional look.

    Fixes & Clean‑Up

    • Scope errors resolved: ContactView and SettingsView now compile without “not in scope” errors.

    • Dead code removed: All AVKit/video bits and unused imports are gone.

    • Padding issues fixed: Featured Projects cards truly span edge‑to‑edge.

    What to Test

    “More” Tab

    Open the More tab, tap Contact → ensure the contact form loads.

    Tap Settings → ensure the Dark Mode toggle and feedback button work.

    Featured Projects

    Scroll to Featured Projects on Home. Verify each card fills the screen width.

    Tap each project → check that title, description, and embedded WebView load correctly.

    Hero Header

    Launch Home → confirm you see the static hero image with “Welcome” text.

    No video should play or attempt to load.

    Services Page

    Go to Services → confirm each card’s background is a dark‑blue → black gradient.

    Tap Learn More on each card → verify navigation to the correct detail view.

    General Navigation & Stability

    Swipe between tabs, open/close views, rotate the device (if supported) → look for layout glitches.

    Watch the console/logs for any errors or warnings (if applicable).

  • Contact Page Improvements:

    • Resolved an issue where the keyboard would not automatically dismiss after completing a form entry, improving overall user experience.

    • Updated the “Send Email” button with a new color to enhance visibility and maintain consistency with the app’s theme.

    Services Page Redesign:

    • Completely reimagined the Services tab to be more interactive and informative.

    • Improved visual hierarchy, added new UI components, and ensured design consistency throughout the app.

    About Section Updates:

    • Adjusted the size and placement of the “Schedule Now” button for better accessibility and visual balance.

    Featured Projects Fix:

    • Fixed a bug where embedded URL previews in the Featured Projects section overlapped the app layout on certain screen sizes, resolving both visual and functional issues.

    Animations & UI Enhancements:

    • Introduced subtle, system-native animations to improve transitions and overall app feel without distracting the user.

    • Added haptic feedback to key buttons across the app for a more tactile interaction.

    UI Consistency Tweaks:

    • Updated font weights, padding, and alignment across pages to support a cohesive design that aligns with the Services page redesign.

    Accessibility Enhancements:

    • Enhanced color contrast (e.g., updated the “Send Email” button) and increased tappable area sizes (such as for the “Schedule Now” button).

    • Added accessibility labels and hints to tabs and buttons app-wide.

    Performance Optimizations:

    • Made several under-the-hood improvements to boost the app’s responsiveness and reduce load times.

    New Feedback Reporting Feature:

    • Added a new “Report Feedback” row under the App Info section in the Settings view.

    • Users can now tap the “Report Feedback” button to automatically open the mail app with a pre-populated email:

    • Subject: “App Feedback”

    • Recipient: hello@szymonstephansikora.com

    Interface Streamlining:

    • Removed the language selector from Settings to simplify the user interface.

  • Contact Page Improvements:

    • Resolved an issue where the keyboard would not automatically dismiss after completing a form entry, improving overall user experience.

    • Updated the “Send Email” button with a new color for better visibility and consistency with the app’s theme.

    Services Page Redesign:

    • Completely reimagined the Services tab to be more interactive and informative.

    • Improved visual hierarchy, added new UI components, and ensured design consistency across the entire app.

    About Section Updates:

    • Adjusted the size and placement of the “Schedule Now” button for better accessibility and visual balance.

    Featured Projects Fix:

    • Fixed a bug where embedded URL previews in the Featured Projects section overlapped the app layout, which caused both visual and functional issues on certain screen sizes.

    Animations & UI Enhancements:

    • Introduced subtle, system-native animations throughout the app to enhance transitions and improve the overall feel without overwhelming users.

    • Added haptic feedback for certain buttons app-wide.

    UI Consistency Tweaks:

    • Updated  font weights, padding, and alignment across pages to match the redesign of the Services page and maintain a cohesive aesthetic.

    Accessibility Enhancements:

    • Adjusted color contrast (specifically the “Send Email” button) and increased tappable area sizes (the “Schedule Now” button).

    • Added accessibility labels/hints to each tab and buttons app-wide.

    Performance Optimizations

Home

Services

About

Scheduler