Offline Workflows
NeoArc works without an internet connection. Learn how to create and edit documentation offline, then sync your changes when connectivity returns.
NeoArc Studio works entirely with local files. No cloud dependency for editing. No server required for creating content. This architecture means you can work offline: on aeroplanes, in remote locations, during network outages. When connectivity returns, sync through Git.
Why Offline Matters
Traditional documentation tools require constant connectivity.
| Traditional Tools | NeoArc |
|---|---|
| Every keystroke sends data to a server | All content lives in files on your machine |
| Opening a page requires a network request | The application reads and writes locally |
| Network lag affects editing responsiveness | No network latency |
| Outages mean no access to documentation | Full access regardless of connectivity |
Working Offline
Before Going Offline
Prepare your workspace while you have connectivity.
Creating Content Offline
All NeoArc features work offline.
Git Operations Offline
Git itself is designed for offline work. While offline, you can perform these operations.
Syncing When Online
Push Your Changes
When connectivity returns, push your local commits to the remote repository.
git push origin my-branchPull Remote Changes
Others may have pushed changes while you were offline.
git fetch origin
git merge origin/main
# Or pull directly to fetch and merge:
git pull origin mainHandling Divergent Changes
If both you and others made changes while you were offline, you may need to merge.
Offline Scenarios
What Requires Connectivity
Some operations do need network access.
| Operation | Requires Network |
|---|---|
| Publishing to cloud | Yes - Uploading to Azure or other cloud storage |
| Git remote operations | Yes - Push, pull, fetch, clone |
| CDN purge | Yes - Clearing Cloudflare cache after publishing |
| Core editing | No - Fully offline |
Local-First Benefits
Beyond offline capability, file-based storage provides additional benefits.
Best Practices
This documentation was written using NeoArc Studio's offline-capable architecture. The same workflow applies to your own documentation projects.