Projects
A Jx project is a folder on your computer. No hosted service holds your work and no account owns it — everything you build in Studio is a plain file inside that folder, which you can back up, copy, or put under version control like any other document. A published site can still keep its own runtime data in a real database (see Databases ); the project you edit is always just files.
What's in the folder
Studio and the folder are two views of the same thing. Each area of your project maps to a subfolder:
| On disk | What it holds | In Studio |
|---|---|---|
pages/ |
One file per page of your site | Pages in the Manage view |
layouts/ |
Shared page shells — headers, footers, wrappers | Layouts |
components/ |
Reusable building blocks | Components |
content/ |
Posts, entries, and other collection content | Content |
public/ |
Images, video, fonts, and other media | Media |
project.json |
The site's settings — name, URL, design tokens | Project settings |
What each kind of file is for — and when to reach for which — is covered in Pages, layouts, and components . The full folder anatomy is documented in Site architecture .
Get a project
There are three ways to end up with a project open in Studio, all available from the Welcome screen :
Create a new one. Click New Project… and pick a template or a complete starter site — or jump straight to the starter gallery with Start from an Example… . You choose the folder it's created in (on studio.jxsuite.com, the GitHub repository); Studio never picks one for you. The whole modal is walked through in Create a project .
Open an existing folder. Click Open Project… and point Studio at a Jx project already on your machine. On studio.jxsuite.com the same button lists the GitHub repositories you can write to instead — pick one and Studio opens it, or use the links in the picker's footer to grant the Jx Suite GitHub App access to more of them. Recently opened projects also appear on the Welcome screen for one-click reopening.
Clone a repository. Click Clone Git Repository… , paste a repository URL, and click Clone — Studio downloads the project and opens it. On platforms linked to a GitHub account, Add Existing Repository… lets you pick from your repositories instead of pasting a URL.
Because a project is just a folder, "moving to Jx" or "leaving Jx" is copying files. Studio never locks your work into a format only it can read.
Next
Create a project — the New Project modal, field by field
Browse your project — the Manage view with live previews
Publish — commit your project and put it live
Suite