Organizing Your Files in Voyage

In this article, you will learn how to use the "Projects" feature to organize your files.

Last updated - July 18, 2024

File organization is an essential part working in Voyage. The more files you create, the more important organization will become. The "Projects" feature in Voyage helps to organize files into folders and projects. The Projects page can be accessed by clicking the "Projects" button on your Voyage homepage.

My Projects

On the "My Projects" page, you will see a list of all of your projects, the number of files in each project, and the last edited date.

The following actions can be performed on this page:

1. 1. The "Open Project" button opens a project in the code editor
   2. The pencil button allows you to update the project name
   3. The trash can button allows you to delete a project
   4. The download button allows you to download a zip file of your project
   5. The "Export to GitHub" button allows you to export your project to GitHub (This is only for districts that have enabled access to GitHub)
      

Files and Folders in Voyage

After opening a project in Voyage, you are able to add folders and files. Click the file name above the text editor to display all folders and files within a project.

In this menu, you have access to the following options:

1. 1. Click the "Change" button next to the project name to change project
   2. Click the "New Folder" icon to add a new folder
   3. Click the "New File" icon to add a new file
   4. Click the 3 dots to the right of a file or project name to open the edit menu

Organize Your Files

It is important to keep your files organized so that you can easily find and view your completed work. There are many ways you can organize your files. Here are two ideas to help you get started.

• Organize your files by lesson:
  • Create a new project for each lesson you work on.
  • Use the titles of the lessons as the project names.
  • Begin a new file for each checkpoint or challenge you work on within a lesson.
  • Use the titles of the challenges as your file names. This is a good option if you have a lot of files to save.

• Organize your files by unit and lesson: 
  • Create a new project for each unit you work on.
  • Start a new folder for each lesson within a unit.
  • Begin a new file for each checkpoint or challenge you work on within the lesson.
  • Use the title of the challenges as your file names.
  • Save your files to the appropriate folder in your project. 

More Tips

• Project names should be clear and simple.
• Projects will appear in the order you create them. They are not listed alphabetically or numerically.
• Make sure you are saving your files to the correct project. Always double-check your project name and file name before you begin coding.
• File names should be detailed and describe what is in the file. This way, you don't have to open a file to see what is in it.
• Make sure you are using the correct file type before you start coding!
  • HTML files should end in .html
  • CSS files should end in .css
  • JavaScript files should end in .js
  • Python files should end in .py
  • Text files should end in .txt