All guides
    How to use Navōn
    5 min read

    How to build a small app in Navōn with the Build tool

    Describe a chore chart, a quiz or a menu planner in plain words and Navōn writes the app while you watch. Here is how to build, change, save and publish one.

    How to build a small app in Navōn with the Build tool

    Build is the part of Navōn where you describe a small app in plain words and watch it get written. A chore chart for the kids, a times-tables quiz, a Shabbos menu planner, a maaser tracker: you say what you want, and the app appears in a live preview that you can try straight away. You do not need to know how to code. This guide walks through it step by step.

    What Build is for

    Build makes small, self-contained apps that run in your browser. It is a good fit for a tool you would otherwise keep on paper or in a spreadsheet. The start screen offers five ideas to get you going: Chore chart, Times-tables quiz, Shabbos menu, Maaser tracker and Countdown. Pick one to fill in the box, then change the wording to suit your family or class.

    Start your first app

    1. Open the app and choose Build from the navigation. The page asks "What do you want to build?"
    2. Type what you want in the box that says "Describe the app you want". Be specific about who it is for and what it should do. "A times-tables quiz for a 3rd grader, with a timer and a score" gives better results than "a quiz".
    3. Press the arrow button, or press Enter. The workspace opens with your conversation on the left and the running app on the right.
    4. Watch the left side. A "Working" panel lists each step as Navōn writes the files, and the preview on the right changes while it works. When it finishes, the panel shrinks to a line such as "5 steps", and Navōn writes a short note about what it made.

    Above the box you can also change the model, and the paperclip button lets you attach a picture or a document, for example a sketch of the layout you have in mind or a list of words for a game. The microphone button lets you dictate instead of typing.

    Try it, then ask for changes

    The preview is a working app, so click through it as a user would. Then ask for changes in the same box, which now says "Ask for a change". Ask for anything: a new screen, a different colour, a bigger button, an extra feature. Each change is a new turn in the conversation, and the preview updates as it is written.

    Two buttons at the top of the preview help you check your work. The phone and desktop icons show the app at a narrow or a wide screen, which matters if you will use it on a phone. The reload icon restarts the preview.

    If something breaks

    Sometimes a finished app hits an error. When that happens Navōn is asked to fix it on its own, at most twice for each request, and then it stops and shows you the error instead of looping. A panel in the preview reads "The app hit an error" and has a Fix it button. Press it to ask for another attempt. If that does not help, describe in your own words what is wrong, or use Try again under the last reply to send your last request once more.

    Checkpoints, the code and downloads

    • Checkpoints: every change is saved. Press the clock icon at the top to see them, newest first, and press Restore beside an older one to put the app back as it was. Restoring is saved as a checkpoint too, so nothing is lost.
    • Code: switch from Preview to Code to read the files. You can edit them by hand and press Save. You cannot edit while Navōn is still working.
    • Name: the name at the top is editable. Click it, type a new one and press Enter.
    • Download: the download icon saves the app as a zip file with a short README. To run it from the zip you open index.html in a browser, and it needs an internet connection to load its libraries.
    • Your apps: go back with the arrow at the top left to see every app you have made, and to delete one. Deleting removes its files, checkpoints and conversation, and it cannot be undone.

    Publishing to the web

    The Publish button opens a box where you choose a short name of 3 to 30 letters, numbers or hyphens. Navōn checks that the name is available and, if so, puts the app on its own website, separate from Navōn. After that the same button reads "Publish latest changes" when you want the live site to match your newest version, and "Take offline" removes it. If you own a domain, you can connect it there too: type the domain, add the records Navōn shows at your registrar, then press Check connection.

    On an account that belongs to a child, publishing is not automatic. The button reads "Ask a parent to publish", Navōn emails the parent, and the app goes live only after the parent says yes.

    What Build will not do

    Build follows the same standards as the rest of Navōn. Your request is checked first, along with any topics or hours a parent has set. The text an app would show its users is checked too, and if it does not pass, the changes from that turn are discarded. A request that is refused comes back with an explanation instead of an app. Build is for small apps, and it does not replace a developer for something large or something that handles private data. It also never paskens: a halachic question belongs with a rav.

    Build is part of the paid plans. To see how chatting works first, read the guide on starting a conversation, or read about what makes Navōn kosher in the main article.

    See everything Navōn can do for a class, a family or a school.

    Common questions

    Can I build an app with Navōn without knowing how to code?

    Yes. In Build you describe the app in plain words, and Navōn writes the files while you watch a live preview. You then ask for changes in the same way. You can read or edit the code if you want to, but you do not have to.

    How do I put a Navōn app on the internet?

    Press Publish at the top of the app, choose a short name for the address, and publish. The app goes live on its own website. Press Publish latest changes later to update it, or Take offline to remove it. If you own a domain, you can connect it from the same box.

    Can my child publish an app they built in Navōn?

    Not on their own. On an account that belongs to a child, the button reads Ask a parent to publish. Navōn emails the parent, and the app goes live only after the parent approves it.

    What if my Navōn app has an error or I don't like a change?

    Press Fix it in the error panel, or describe the problem and ask again. To undo a change, open Checkpoints with the clock icon and press Restore beside an earlier version.

    Published by Navōn. How these guides are written and checked.

    Read next