Create a project

New fresh projects can be created with the fresh CLI tool. It will scaffold out a new project with some example files to get you started.

To create a new project in the directory "my-project", run:

$ fresh init my-project
Manifest generated and written to ./my-project/fresh.gen.ts

This will create a directory containing some files and directories. There are 3 files that are strictly necessary to run a fresh project:

• main.ts: This is the entrypoint for your project. It is the file that will you run to start your fresh application. This file doesn't actually need to be called main.ts, but it's best practice to call the entrypoint main.ts.
• fresh.gen.ts: This is the manifest file that contains information about your routes and islands. This file is automatically generated based on your routes/ and islands/ folder by the fresh CLI when running the fresh manifest command.
• import_map.json: This is an import map that is used to manage dependencies for the project. This allows for easy importing and updating of dependencies.

A deno.json file is also created in the project directory. This file does two things:

• It tells Deno about the location of the import map, so that it can be loaded automatically.
• It registers a "start" task to run the project without having to type a long deno run command.

Two important folders are also created that contain your routes and islands respectively:

• routes/: This folder contains all of the routes in your project. The names of each file in this folder corresponds to the path where that page will be accessed. Code inside of this folder is never directly shipped to the client. You'll learn more about how routes work in the next section.
• islands/: This folder contains all of the interactive islands in your project. The name of each file corresponds to the name of the island defined in that file. Code inside of this folder can be run from both client and server. You'll learn more about islands later in this chapter.

Finally a static/ folder is created that contains static files that are automatically served "as is". Learn more about static files.