Using the WriteFreely iOS App

You can publish to your WriteFreely / Write.as blog on the go with the WriteFreely iOS app.

This guide will introduce some of the features of the app, and how it works with your WriteFreely account. It requires an iOS device running iOS/iPadOS 14.0 or later; you can download it on the App Store.

Creating Your First Post

You don’t need to log into any account to begin writing. The app will launch straight to the post editor, where you can start writing a local post that only exists on your device — they’re not synced anywhere until you explicitly publish them to the server.

Give your post a title by tapping where it says “Title (optional)”, and then tap on “Write…” below it to being writing your post. New local posts are automatically added to the blog you’re currently viewing (in this case, Drafts), and they’re saved automatically when you leave the post editor, or load another post. Blank posts are deleted when you navigate away from them.

To create another new local post, tap the New Post button at the top-right of the post list. You’ll see a new post added to the top of the list, and it should load in the editor right away.

Getting Set Up

Logging In to Your Account

Tap the Settings button at the bottom-left of the post list to open the app’s Settings screen. At the top of the screen, a form prompts you to log in to publish and share your posts. Enter your username and password, as well as the URL of the WriteFreely instance that hosts your account. For Write.as accounts, use https://write.as as the server URL.

:warning: To keep your account secure, the app will not communicate over an insecure connection. If you provide an address with the http:// protocol, it will attempt to connect over https://. If it cannot, you’ll get an error message.

Once logged in, the app will fetch all of the posts and blogs in your account. Any local posts you’ve created are kept after logging in, and you can then publish them to your blog. See the Working With Posts section for details.

:warning: Tapping Log Out in the Settings screen will disconnect the app from the server and remove all your published content from the device, including any changes you’ve made that you haven’t pushed to the server. As of v1.0.1 of the app, your local posts are preserved.

Setting Your Appearance Preferences

Below the login form on the Settings screen, you can define some appearance preferences. You can choose whether you prefer to use the app in light mode, dark mode, or to have it switch based on your system settings.

You can also choose the default font for new local posts created on the device. This does not override the font used in existing posts; you can only change the font for published posts from the web application.

Navigating The App

The WriteFreely app uses a typical three-level hierarchy, much like the Mail app on your iOS device. Choosing a blog in the first column will show you its posts in the second column; choosing a post from that list will load it for you in the post editor.

On a 12.9" iPad Pro in full-screen landscape orientation, you can see all three columns at the same time; on other iPads in full-screen landscape orientation, you’ll see the post list and post editor at the same time. Otherwise, use the navigation button at the top-right of the screen to navigate back on iPhone and on iPad in portrait or split-screen orientation.

Post status

In the app, posts can have one of three statuses:

  • Local means that the post was created on the device, and has never been published to the server.
  • Published means that the post was fetched from the server.
  • Edited means that the post was fetched from the server, and has been edited in the app, but these changes have not yet been published to the server.

Working with posts

Generally, there are three actions you can take on a post: publishing, sharing, or moving. These are made available by tapping on the Menu button at the top-right of the post editor.

A local post can only be published. Choose Publish… from the menu and you’ll be presented with a list of blogs you can publish the post to. If you’re not logged in, trying to publish will open the Settings screen and prompt you to log in.

A published post can be shared or moved; an edited post can be published, shared, or moved.

Choose Publish from the menu to publish the changes made to an edited post back to the server. This changes the status of the post from edited back to published.

Choose Share from the menu to open the system share sheet, where you can send a link to your post through any compatible app on the device.

Under the Move to… section of the menu, tap the name of the blog you’d like to move the post to. The checkmark indicates what blog the post currently belongs to.

To make a local post available on the web or another device, publish it to the web as a Draft (“Anonymous” post on Write.as).

Server sync

The app periodically fetches your content from the server automatically. You can force it to fetch by tapping the Reload button at the bottom-right of the post list.

:warning: Note that this never replaces the content on your device with content from the server. If a post has been changed or deleted on the server, you’ll be shown this information when you view the post in the app. You can then choose to make the same changes in the app.

Getting help

Need help? Tap Visit Help Forum in the app’s Settings screen to be taken to the help forum where you can ask a question or search for answers.

2 Likes

Great work! Thanks!

The main thing I can think of that I didn’t see listed was integration with snap.as. Almost every post I write has a picture. Definitely not a 1.0 feature, but I’d sure like to see it on the list. This might actually convince me to upgrade to iOS 14.

Thanks again!

2 Likes

Thanks for the kind words! As someone who uses Snap.as a lot for sharing screenshots, I can totally understand the value integrating it into the iOS app. :slight_smile:

As someone who is trying to avoid installing more apps on my smartphone, I probably won’t install it. But I also wanted to say, that this looks great! I’m sure a lot of people will make good use of it.

1 Like

Thanks! I can definitely relate to keeping installed apps at a minimum. :sweat_smile:

4 posts were split to a new topic: New local posts take time to appear on device after publishing

I just published my first post using the new iOS WriteFreely app. The only quirk I noticed is the font in the app has carried into my blog, i.e. the blog’s font /theme has been overridden.

Is this a bug or do I need to change a setting?

Hmm. Another feature I’d like to see… a way to publish to Twitter, just as I do on the write.as website. Again, completely understandable it’s not in 1.0, but that and the snap.as integration mean I’ll probably keep using the website for now.

Welcome to the community, @AlanGM! Moving this conversation here.

Thanks for the feedback, @davepolaschek! I believe that the crossposting API for Twitter is Write.as-only — for the 1.0 launch we focused primarily on the features that both Write.as and WriteFreely share. I’m noting your interest in seeing crossposting added to the app, though!

1 Like

Hey, I just installed the app and it’s really nice. Well done.

I have a request though - support for accepting an object shared from another app as a new post.

Hey @isjamesalive, thanks for the kind words!

We have an issue open on GitHub for adding an Action extension to the iOS app. This would make it possible to, for example, select some text, and create a new post from it in the WriteFreely app.

If you have any other thoughts on what you’d like to see, let us know!

Thanks! can totally relate to limiting the number of installed programs.

I admit I am no longer using the ios app due to ghosting of anonymous posts when created in ios, edited on web, moved to a named blog. On ios they then often stay in the anonymous section with an edited mark. It ended up being too messy, and stopped using ios app.

Thanks for reporting this bug! I’ve been able to reproduce it and I’ll work on a fix for it. GitHub issue is here: Moving a post created in-app to a blog on the web doesn't update the app correctly · Issue #247 · writefreely/writefreely-swiftui-multiplatform · GitHub