Support

Proselens Support

Help and contact information for Proselens: Writing Clarity (version 1.2).

Getting Started

Open Proselens and tap "Try a sample" on the empty editor, or paste any text. The clarity score, inline highlights, and metrics appear within a fraction of a second. No account or setup needed.

Writing Target

Go to Settings → Writing Target, choose your audience, then open the Stats sheet (tap "Stats" in the bottom bar or tap the score ring). The sheet shows whether your grade level is on target, too complex, or too simple for that audience.

Simpler Alternatives

Tap "Issues" in the bottom bar. Complex-word rows show a suggested plain replacement below the flagged word — for example, utilize → use or methodology → method. Tap any row to jump to that word in the editor.

Share Analysis Report

Tap "Stats", then the share icon (top left of the sheet) to export a plain-text summary of every metric and index. Or use the "..." menu in the editor and choose "Share analysis report".

Word Frequency

Tap "Stats" in the bottom bar, then scroll down and tap "Word Frequency". The sheet lists your top content words ranked by how often they appear, with a frequency bar for each one. A Type–Token Ratio (TTR) badge at the top tells you whether your vocabulary variety is High, Good, Fair, or Low. Function words, articles, and filler are excluded so only meaningful words count.

Sentence Length Distribution

Open "Stats" and scroll to the "Sentence Length Distribution" card. Each bar represents one sentence; bar length corresponds to word count, and the color matches the editor's highlights (green = short, amber = hard, red = very hard). If your sentences are all the same length, a tip will appear suggesting you vary the pacing.

Clarity Delta

After saving a document at least twice, the Library row shows a small +/– badge next to the clarity score. Green means the most recent save improved the score; red means it got harder. The badge appears automatically whenever the score changes.

Need Help?

Email the App Store product page with your device model, iOS version, and a short description of what happened. Every message is read personally.

Common Questions

Does Proselens require an internet connection?
No. All analysis is done on-device using Apple's NaturalLanguage framework. The app works completely offline.

Does the app require an account?
No. There is no account, sign-in, or registration of any kind.

Where are my documents stored?
Saved documents are stored in your device's Application Support directory as a local JSON file. Nothing is sent to any server.

What are the new readability indices in v1.2?
Version 1.2 adds Gunning Fog, SMOG Grade, Automated Readability Index (ARI), and Coleman-Liau to the Stats sheet. Each uses a different signal — polysyllable count, character frequency, letter frequency — so comparing them gives a fuller picture of your text's complexity.

How do I use Word Frequency?
Open the Stats sheet (tap "Stats" in the editor bottom bar or tap the score ring), scroll to the bottom, and tap "Word Frequency". The sheet shows your top content words by count, a vocabulary variety rating, and a citation for the stop-word list used.

What is Type-Token Ratio (TTR)?
TTR = unique content words ÷ total content words. A ratio of 1.0 means every content word appeared exactly once (maximum variety). Repetitive texts score low. The app labels the ratio as High (≥80%), Good (55–80%), Fair (35–55%), or Low (<35%).

How do I change which checks are shown?
In the Settings tab, toggle any highlight category on or off. The clarity score and counts update immediately.

How do I adjust what counts as a "hard" sentence?
In Settings → Thresholds, use the steppers to change the word-count cutoffs for Hard and Very Hard sentences.

Can I export my documents?
Use the share button (up-arrow icon) in the bottom bar to share the raw text. Use "Share analysis report" for a full metrics export.

What does the +/– badge in the Library mean?
It shows how much your clarity score changed since the previous save. A green +12 means the latest revision is 12 points clearer than the version before it. It appears only when the score actually changed.