Browser demo

The live SahajLipi demo lets you try the current Nepali typing experience in a browser. This page covers the demo interface and how to run it. The package website introduces the library and provides developer documentation. For the reusable conversion engine, browser adapter, API, and typing rules, start with the package documentation.

This guide describes the repository demo, including the full-consonant behavior introduced in alpha.2, the Consonants selector and the 13-key spelling slice shipped in alpha.3. Website deployment is separate from npm publication. Alpha.1 retains its earlier half-consonant fallback; the release record distinguishes registry packages from the repository demo. The repository demo also includes the 34-key native-form batch shipped in alpha.4. The original alpha.3 artifact excludes these later forms; website deployment remains separate from npm publication.

Run it locally

From the repository root, with Node.js 20 or later, npm, and Python 3 available:

npm ci
npm run demo

Open the local demo. The command builds and serves the complete package website, documentation, and demo together. Home and logo links therefore reach the package homepage, and documentation links open the generated guides. The earlier http://127.0.0.1:4173/demo/ address redirects to this canonical local path; / redirects to the package homepage at /sahajlipi/.

After a source change, restart npm run demo to rebuild the artifact. This command needs the website development dependencies installed by npm ci; it does not publish anything to npm or GitHub Pages.

To try the demo on another device on the same local network, bind the server to your computer's current private IPv4 address:

npm run demo:lan -- YOUR_LAN_IP

Replace YOUR_LAN_IP with that address, then open http://YOUR_LAN_IP:4173/sahajlipi/demo/ on the other device. The command builds the same complete website before serving it; the older /demo/ address also redirects correctly. The devices must be able to reach each other on the local network. Stop an existing server on port 4173 before starting another one.

Use the page

• Type in the editor. Roman letters turn into Nepali in the same textarea. Space commits the displayed word; Backspace can edit the active Roman spelling. The on-page How to type guide shows examples for vowels, full consonants, automatic conjuncts, explicit half forms, cha/chha, the two र्य/र्‍य forms, listed word shortcuts, reviewed native spellings, English loanwords and their supported suffixes, full English month names, Shift sounds, marks, digits, punctuation, mixed text, and alternatives. The package typing reference documents the complete rules and the scope of those word entries.
• Choose consonant behavior. Consonants → Full (default) displays full bare and final consonants, such as k → क and kr → क्र. Strict half retains alpha.1 fallback endings, such as k → क् and kr → क्र् until a vowel completes them. The selector controls the main editor and all three marked form fields. Changing it finishes their active words and preserves existing text and Nepali/English mode; subsequent typing and paste use the selected behavior.
• Choose a reading. When the active spelling has multiple listed readings, a dropdown appears below the textarea. The first reading is displayed by default. Choose another from the dropdown or press Alt + a number from 1 through 9 while the word is active.
• Switch mode. The button shows Nepali mode when conversion is on and English mode when input is literal. It controls subsequent typing and paste in every marked field on this page: the main editor and the three form examples. Existing text stays as it is when you switch modes.
• Try form fields. The two marked text fields and marked search field below the editor use the same conversion setup. The mixed-text field lets you try Nepali beside a link or email address. The unmarked text and email fields stay in English. The alternatives dropdown and character count belong to the main editor; in the form fields, Alt + a number can select an available alternative.
• Copy or clear. Copy writes the main editor value to the clipboard when the browser permits it. If clipboard access fails, the page selects the text for manual copying. Clear empties the main editor. The character count updates with its displayed text.

The fields keep text and their undo snapshots in browser memory while the page is open. The demo does not provide accounts or cloud storage. Its core and adapter do not make network requests to convert text; the browser still requests the static page files from the hosting server.

Words and sounds to try

Full consonants and explicit halves

With Full (default) selected, both k and ka → क, and both kr and kra → क्र. Internal conjuncts form automatically: kri → क्रि and shakti → शक्ति. Use a to separate consonants: kar → कर.

Type backtick or / for an explicit half form: k` or k/ → क्, and kr` or kr/ → क्र्. Spaces and punctuation preserve that half form in either selector setting. A following vowel starts independently: k`i or k/i → क्इ; use ki → कि for the attached vowel sign. Backtick followed by = or /= adds a joiner after the virama: par`=yo and par/=yo → पर्‍यो.

Strict half changes phonetic fallback endings only. Exact listed words and their candidate order retain priority. Developers can apply the same configuration with createEngine({ consonantMode: 'half' }); see the browser migration recipe.

च and छ

cha displays च first and offers छ in the readings dropdown. Use chha for छ directly. With Full (default), bare ch gives च and chh gives छ; add backtick or / for च् or छ्. Strict half keeps bare ch → च् and chh → छ्. Listed complete words keep their own spelling: huncha still gives हुन्छ. Vowel lengths and Shift sound keys keep their explicit rules.

Reviewed native-word spellings

The original four reviewed keys were included before alpha.3 and remain available in the published package and repository demo: halyo → हाल्यो, nabhani → नभनी, gaunle → गाउँले and dindaina → दिँदैन.

The repository demo also includes the 13-key spelling update shipped in alpha.3:

Type	Output	Type	Output
imandar	इमान्दार	sarasar	सरासर
sakos	सकोस्	kathanak	कथानक
arambha	आरम्भ	ekadhik	एकाधिक
jaghanya	जघन्य	pukar	पुकार
niskanda	निस्कँदा	bora	बोरा
utthan	उत्थान	samanjasya	सामञ्जस्य

Type bhagna to display भग्न, then choose भाग्न from the readings dropdown or press Alt+2 while the word is active. These are distinct valid readings; the first preserves the existing default rather than ranking their meanings. Space commits the displayed choice.

These exact aliases supply reviewed whole-word spellings. An unfinished or unlisted spelling can use the phonetic fallback; attached native forms are not inferred. Incidental capitals such as Imandar work, while reserved Shift spellings such as Sarasar keep their explicit sounds. English mode keeps these keys literal.

The earlier four-word review and alpha.3 batch review record sources, decisions and measurements. The demo uses the repository engine in either consonant setting.

The later 34-key native-form batch adds complete spellings such as astitwalai → अस्तित्वलाई, karyaharuma → कार्यहरूमा, pairaheka → पाइरहेका and samhalnubhaeko → सम्हाल्नुभएको. Type mahila for महिला and choose माहिला; type shanta for शान्त and choose शान्ता; or type angrejharuko for अङ्ग्रेजहरूको and choose अंग्रेजहरूको. The dropdown or Alt+2 selects the second reading while the word is active. The first two orders are maintainer choices, and the third preserves the explicit velar-nasal style. None is a frequency claim.

The native-form guide lists all 34 mappings, sources and 12 deferred cases. These are complete-key preferences in either consonant setting; they do not teach the engine arbitrary native suffixes. The earlier four-word review and earlier 13-key review retain their dated sources and measurements.

English loanwords

The default engine includes 51 recognized English-spelling loanword stems: the earlier 50 keys plus media → मिडिया. The finite suffix rule also accepts 19 attached suffix keys on these stems. They work automatically in the editor and marked text/search fields while Nepali mode is on; the demo needs no separate loanword setting. These are source-assisted project spelling preferences, not independently human-reviewed language labels or an exhaustive loanword dictionary. See the dated suffix review for the current rules and evidence; the earlier expansion and original pilot keep their historical counts.

school displays स्कुल first and offers स्कूल in the readings dropdown. Attached school forms offer the same ordered readings: schoolma displays स्कुलमा and offers स्कूलमा. Other built-in loanword stems currently have one reading. Additional spellings and alternate senses may need separate review.

Original 20 keys

English key	Nepali spelling
camera	क्यामेरा
computer	कम्प्युटर
mobile	मोबाइल
phone	फोन
charger	चार्जर
printer	प्रिन्टर
mouse	माउस
internet	इन्टरनेट
email	इमेल
software	सफ्टवेयर
scanner	स्क्यानर
video	भिडियो
taxi	ट्याक्सी
bank	बैंक
cheque	चेक
file	फाइल
school	स्कुल; alternative स्कूल
college	कलेज
doctor	डाक्टर
nurse	नर्स

Company and 12 entries from the earlier research queue

English key	Nepali spelling
company	कम्पनी
bus	बस
cricket	क्रिकेट
football	फुटबल
hotel	होटल
keyboard	किबोर्ड
laptop	ल्यापटप
microphone	माइक्रोफोन
office	अफिस
password	पासवर्ड
restaurant	रेस्टुरेन्ट
ticket	टिकट
wifi	वाइफाइ

17 further source-attested entries

English key	Nepali spelling
ambulance	एम्बुलेन्स
battery	ब्याट्री
car	कार
carpet	कार्पेट
connector	कनेक्टर
courier	कुरियर
digital	डिजिटल
drone	ड्रोन
furniture	फर्निचर
inverter	इन्भर्टर
motorcycle	मोटरसाइकल
radio	रेडियो
router	राउटर
sofa	सोफा
telephone	टेलिफोन
van	भ्यान
website	वेबसाइट

media is the latest key and uses मिडिया.

Try company camera computer → कम्पनी क्यामेरा कम्प्युटर or school office hotel → स्कुल अफिस होटल. These entries spell borrowed words in Nepali; they do not translate English sentences or decide a word's meaning. train, speaker, fax, wallet, and share are not built-in loanword keys in this expansion; spelling or meaning decisions remain open in the expansion review.

Supported attached forms

Try companyharumathi → कम्पनीहरूमाथि, schoolma → स्कुलमा / स्कूलमा, or mediasanga → मिडियासँग. Append one of ma, ko, ka, ki, le, lai, bata, sanga, mathi or haru to a listed loanword stem. haru may also be followed by one of the other nine endings: for example, companyharuko → कम्पनीहरूको. The complete suffix table lists all 19 keys and their native endings.

The stem retains its vowels and readings when a recognized suffix is complete. While typing an unfinished suffix, the whole spelling may temporarily use phonetic conversion; it becomes the derived form once the complete suffix key is present. Space commits the current reading. Backspace re-evaluates the remaining Roman keys.

Unsupported endings such as cameramaa, extra suffix chains and arbitrary new stem keys still use ordinary conversion. These spelling rules do not choose sentence grammar, translate English phrases or infer month/native-word suffixes.

Use the lowercase spellings in the tables for predictable results. Incidental capitals such as Company, Camera, and Computer match too, but T, D, S, R, and contextual H still select sounds. Doctor, School, all-capital keys, and arbitrary mixed case are not guaranteed aliases. Existing explicit name aliases, such as Ram and Sita, keep their listed readings.

A domain like company.com stays literal under the separate mixed-text rule below. English mode and the unmarked English fields leave English words unchanged; choose those when you intend literal English. The package typing reference and API guide give the precise conversion boundaries.

English month names

All 12 full English month names work automatically in Nepali mode, in the editor and all three marked form fields. Each has one preferred spelling, so no readings dropdown appears for these entries. The normal title-case forms also work, including September and December.

English keys	Nepali spelling
january	जनवरी
february	फेब्रुअरी
march	मार्च
april	अप्रिल
may	मे
june	जुन
july	जुलाई
august	अगस्ट
september	सेप्टेम्बर
october	अक्टोबर
november	नोभेम्बर
december	डिसेम्बर

Try January February March → जनवरी फेब्रुअरी मार्च or September December → सेप्टेम्बर डिसेम्बर. These source-assisted project spellings are documented with their evidence in the month reference; independent human linguistic review remains pending.

May and may both give मे. The engine cannot recognize English modal-verb uses of “may”; use English mode or an English field for them. Native Roman input such as maya keeps its existing behavior. The month entries match full words only: abbreviations such as jan, feb and sep, and attached forms such as januaryma, keep ordinary conversion. There is no general all-capital or mixed-case English matching; reserved Shift keys still select sounds. The feature spells month names and does not convert dates to the Bikram Sambat calendar.

Numbers and decimals

In Nepali mode, number keys display Devanagari digits automatically: 0123456789 → ०१२३४५६७८९. Try 3.14| → ३.१४। or September 27, 2026 → सेप्टेम्बर २७, २०२६. The period remains a period; the converter changes digit characters without changing the number, year, or calendar. Typed and pasted numbers follow the same policy in every marked field.

Numbers within recognized links and emails keep their original characters: name123@example.com and https://example.com:8080/a2?q=2026 stay as typed. Before an address cue appears, digits convert normally; uninterrupted typing restores the current token when the cue appears. English mode preserves ASCII digits from the first key and leaves earlier text unchanged. The unmarked English and email fields remain literal.

The demo uses the package default. Developers can choose ASCII digits for their own integration with the engine's digits: 'latin' configuration; there is no separate demo digit control.

Nepali beside links and email

In Nepali mode, recognizable HTTP(S) links, www. addresses, ASCII domain-shaped hosts, and ordinary ASCII email addresses stay literal automatically. Original case, paths, query strings, and fragments stay intact. Try these by typing continuously or pasting them into the editor or mixed-text form field:

namaste camera.com name+tag@example.com
→ नमस्ते camera.com name+tag@example.com

namaste https://Example.com/a|b?q=camera#may pani|
→ नमस्ते https://Example.com/a|b?q=camera#may पनि।

The converter switches the current token back to Roman text as soon as an early address cue appears: http:, https:, www., an ordinary ASCII local part followed by @, or the first letter after a domain dot. It preserves https:, www., name@, name@example, and camera.c before they are complete addresses. The same examples stay literal when pasted.

Before a cue, letters and digits still follow Nepali conversion: camera becomes क्यामेरा and camera. remains क्यामेरा. A trailing period alone is sentence punctuation. The current token can be restored while you type continuously; previously committed text cannot be reconstructed into Roman input. Switch to English mode before the first key if you want a fragment to stay literal from its beginning.

The policy checks a shape, not whether the address exists: pani.paani and its unfinished form pani.p also stay literal. It accepts unfinished addresses without validating them and has ASCII scope; internationalized addresses and arbitrary English, code, or filenames are outside the automatic handling. A pipe after a bare domain gives danda (camera.com| → camera.com।), but inside a URL suffix it stays literal (camera.com/a| stays as typed). Add a space before the pipe for sentence punctuation after a path: camera.com/a | → camera.com/a ।. The package API guide defines the full policy.

Keep an English phrase literal

Switch to English mode before typing or pasting an English phrase, acronym, or code fragment; switch back to Nepali mode when ready to continue Nepali. The button controls all marked fields together, and it leaves existing text as it is. In English mode, digits and shortcut characters such as ^, ~, backtick, /, and | stay literal too. Changing Consonants preserves English mode. The unmarked English notes and email-only fields always preserve what you type.

How the demo connects to the package

demo/index.html defines the editor, controls, candidate dropdown, three marked form fields, and on-page guide. demo/style.css styles them. demo/main.js creates an engine using the selected consonantMode, imports attachNepaliInputs from src/dom.js, and calls it once for all fields marked data-sahajlipi. Both conversion callbacks use the current engine, so selector changes apply to live typing, paste, and completed composition. The manager supplies the main editor's controller for its candidate dropdown and clear control; its setEnabled() method switches Nepali typing for every marked field. Copy reads the main editor's value. The unmarked English text and email fields have no adapter. Editing and conversion behavior lives in the package code, so the demo exercises the same functions that developers can embed in their own apps.

Brand assets

The demo header uses SahajLipi's vector mark beside the visible project name. Favicons and an Apple touch icon use the same mark; page metadata uses the shared social preview when the demo is linked. The brand guide covers the logo variants, colors, and asset usage. The current demo supports Nepali typing.

Published version and limits

The generated package website keeps the interactive demo at /demo/. Its Pages artifact includes the demo, engine modules, and brand assets. Demo changes appear after they merge to main and the website deployment finishes. The default local demo command also builds the complete website so its Home and documentation navigation works; the website guide explains the production build and publishing source. The separate browser adapter compatibility guide records automated desktop-engine editing checks and selected demo flows, with reproducible commands and CI reports. Injected paste/composition contracts do not test a real clipboard or IME. Real mobile keyboards, assistive technology, installed Safari, and framework-controlled fields remain unverified. The demo is a prototype, and unknown words can produce an incorrect spelling. The package documentation explains the API, current typing rules, architecture, and evaluation evidence.