Private vs Public Apps

Understanding App Status

When creating an app on HTMLSync, you can choose between two visibility modes:

  • Private: Only accessible to you when logged in
  • Public: Read-only access to anyone with the direct link

In both modes the data displayed in the app is synced, but public users can not add/edit/delete data.

Private Apps

What are Private Apps?

Private apps are only accessible when you're logged into your HTMLSync account. This provides a secure environment for personal tools and sensitive data.

Key Features

  • Secure Access: Requires authentication to view or use
  • Personal Data: Safe for storing personal information

Use Cases

  • Personal task managers
  • Private journals
  • Financial tracking tools
  • Development prototypes and experiments
  • Apps containing API keys or personal configurations

Access Pattern

https://[app_slug]-[username].htmlsync.io
↓
Login Required → Authentication Check → App Access

Public Apps

What are Public Apps?

Public apps can be accessed by anyone who has the direct link, without requiring authentication. Public users can only view the application. The app still belongs to your account and uses your storage quota. If public users try to apply any changes to your app, they will see the notification below:


Screenshot of the public app notification


You can also hide elements from public users by using the .public-hidden class:

<div class="public-hidden">
  <!-- This element will be hidden from public users -->
</div>


In the screenshot below, I have hidden the To-Do list input and button from public users:


Screenshot of the public app notification


Key Features

  • Direct Access: No login required for viewers
  • Shareable: Easy to share with others via link
  • Demonstration: Perfect for showcasing your work

Use Cases

  • Portfolio pieces and demonstrations
  • Utility tools for sharing (calculators, converters)
  • Public dashboards and displays
  • Educational tools and examples
  • Open-source project demos

Important Considerations

  • Data Privacy: Anyone with the link can see the app
  • No User Separation: All users share the same localStorage data
  • Public Visibility: Your app may be discoverable
  • Resource Usage: Counts against your account limits

Access Pattern

https://[app_slug]-[username].htmlsync.io
↓
Direct Read-Only App Access (No Authentication Required)

Switching Between Modes

Changing App Status

You can change your app's status at any time:

  1. Go to your Apps dashboard
  2. Click on the app you want to modify
  3. Update the Status field
  4. Click Save
Screenshot of the app status selector

What Happens When You Switch

Private → Public

  • App becomes immediately accessible without login
  • Existing localStorage data remains intact
  • URL stays the same
  • App appears in public listings (if applicable)

Public → Private

  • App requires login to access
  • Anonymous users lose access immediately
  • Your localStorage data is preserved
  • App removed from public listings