Introduction to Typevia

For many beginners, the most daunting part of learning LaTeX is the initial setup. Installing a TeX distribution (like TeX Live or MiKTeX) and a dedicated editor can be time-consuming and technically challenging. This is where Typevia comes in.

Typevia is a cloud-based LaTeX editor that allows you to write, edit, and publish your documents directly in your web browser with AI assistant. Think of it as "Cursor for LaTeX." It handles all the heavy lifting of installation and package management in the cloud, allowing you to focus entirely on your content.

Why use Typevia?

Modern AI Support: Use AI to draft, edit, and refine your articles.
No Installation Required: You only need a web browser and an internet connection.
Real-time Collaboration: Multiple people can work on the same document simultaneously.
Automatic Backups: Your work is saved automatically to the cloud.
Built-in Templates: Thousands of templates for resumes, journal articles, and theses are available at the click of a button.
Rich Text Mode: If you find the code intimidating, you can switch to a visual editor and still use AI with it.

Navigating the Typevia Interface

When you open a project in Typevia, the screen is divided into three main sections. Understanding this layout is key to working efficiently.

The File Tree / AI Agent (Left Panel): This lists all the files in your project, including your .tex source files, images (like .jpg or .png), and bibliography files (.bib). You can select the AI chat from the same left sidebar.
The Editor (Middle Panel): This is where you write your LaTeX code. It features syntax highlighting to help you distinguish between commands and text.
The PDF Preview (Right Panel): After you "compile" your code, the resulting PDF appears here.

Note: You can adjust the width of these panels by clicking and dragging the borders between them. If you need more space to write, you can collapse the File Tree using the arrow icon.

Creating Your First Project

Let's start with a basic project. When you create a "Blank Project" in Typevia, it automatically generates a minimal template for you.

Every LaTeX document on Typevia starts with a Preamble (everything before \begin{document}) and a Body (everything between \begin{document} and \end{document}).

Basic Template Example

Here is what a standard starter file looks like. You can copy and paste this into your editor:

\documentclass{article}

% --- Preamble Area ---
\usepackage[utf8]{inputenc} % Allows for special characters
\title{My First Typevia Project}
\author{Your Name}
\date{\today}

% --- Document Body ---
\begin{document}

\maketitle % This command prints the title, author, and date

\section{Introduction}
Hello! This is my first document created in Typevia. Writing in LaTeX is 
different from Word because I focus on the content first, and the 
software handles the formatting.

\section{Why I like LaTeX}
\begin{itemize}
    \item It handles mathematical formulas beautifully.
    \item It manages citations automatically.
    \item It looks professional.
\end{itemize}

\end{document}

How to see your results

To see how this looks as a PDF, click the green Recompile button at the top of the right panel.

Pro-Tip: You can use the keyboard shortcut Ctrl + Enter (Windows/Linux) or Cmd + Enter (Mac) to recompile your document instantly without clicking the button.

Managing Images and Uploads

One of the most common tasks in LaTeX is adding images. Unlike word processors, you don't "copy-paste" an image into the document. Instead, you upload the image file to Typevia and tell LaTeX where to find it (or directly prompt the AI agent after image upload to insert your image for you!).

Step 1: Uploading

Click the Upload icon (an upward arrow) in the File Tree panel. You can drag and drop images from your computer here.

Step 2: The Code

To display an image, you must include the graphicx package in your preamble and use the \includegraphics command.

\documentclass{article}
\usepackage{graphicx} % Required for inserting images
\graphicspath{ {images/} } % Optional: tells LaTeX images are in a folder

\begin{document}

\section{Adding a Picture}
Below is an example of an image uploaded to my project.

\begin{figure}[h]
    \centering
    \includegraphics[width=0.5\textwidth]{my-image-name}
    \caption{This is a description of my image.}
    \label{fig:my_picture}
\end{figure}

\end{document}

Warning: Make sure the filename in \includegraphics{...} matches the uploaded file exactly, including capitalization. If your file is Photo.jpg, using \includegraphics{photo.jpg} will cause an error.

Collaboration and Version Control

Typevia's strongest feature is its ability to facilitate teamwork.

To invite someone to your project, click the Share button in the top-right corner. You can:

Invite specific people via email.
Turn on "Link Sharing" to give anyone with the link view or edit access.

Reviewing and Commenting

If you are working with a supervisor or a classmate:

Track Changes: Use the "Review" toggle at the top of the editor. When this is on, any additions or deletions will be highlighted, allowing others to accept or reject them.
Comments: Highlight a piece of text and click "Add Comment" to start a discussion thread in the margin, similar to Google Docs.

History and Backtrack

Accidentally deleted a whole paragraph? Click the History button. Typevia keeps a record of your changes. You can view previous versions of your document and restore them if needed. This provides a safety net that local editors often lack.

Best Practices and Common Mistakes

To keep your Typevia experience smooth, follow these industry best practices:

1. Organize with Folders

As your project grows (e.g., a thesis), your file tree can become cluttered. Use the New Folder icon to create folders named images, chapters, or data. This keeps your workspace tidy.

2. Check the Error Log

If the "Recompile" button turns red or shows a small yellow warning sign, LaTeX has encountered a problem. Click the Logs and output files icon (next to the Recompile button) to see the error message.

Red errors: These must be fixed, or the PDF won't update.
Yellow warnings: These are suggestions (like an image being too wide), but the PDF will still generate.

3. Use "Auto-Compile" sparingly

Typevia has an "Auto-compile" setting (under the arrow next to the Recompile button). While convenient, it can drain your browser's performance on very large documents. For beginners, manual recompilation is usually better for learning.

4. Keep your Preamble clean

Don't load packages you aren't using. If you copy code from the internet, try to understand what each \usepackage{...} command does before adding it to your project.

Common Beginner Pitfalls

Forgetting to close environments: Every \begin{...} must have a matching \end{...}.
Special Characters: Characters like %, $, and & have special meanings in LaTeX. If you want to print them as text, you must use a backslash (e.g., \%, \$, \&).
Large Images: Uploading massive 20MB image files can slow down compilation. Try to resize images to a reasonable resolution before uploading.

By using Typevia, you are joining a global community of researchers and students. Its accessible interface removes the technical barriers to LaTeX, letting you produce beautiful, professional documents from day one.

Introduction to Typevia

On this page