Fresh

The next-gen web framework.

Full-stack frameworkDeno
denoland/freshfresh.deno.dev

README

Documentation | Getting started

fresh


the fresh logo: a sliced lemon dripping with juice

Fresh is a next generation web framework, built for speed, reliability, and
simplicity.

Some stand-out features:

- Just-in-time rendering on the edge.
- Island based client hydration for maximum interactivity.
- Zero runtime overhead: no JS is shipped to the client by default.
- No build step.
- No configuration necessary.
- TypeScript support out of the box.
- File-system routing à la Next.js.

📖 Documentation


The documentation is available on
fresh.deno.dev.

🚀 Getting started


Install Deno CLI version 1.25.0 or higher.

You can scaffold a new project by running the Fresh init script. To scaffold a
project in the deno-fresh-demo folder, run the following:

  1. ```sh
  2. deno run -A -r https://fresh.deno.dev deno-fresh-demo
  3. ```

Then navigate to the newly created project folder:

  1. ```
  2. cd deno-fresh-demo
  3. ```

From within your project folder, start the development server using the
deno task command:

  1. ```
  2. deno task start
  3. ```

Now open http://localhost:8000 in your browser to view the page. You make
changes to the project source code and see them reflected in your browser.

To deploy the project to the live internet, you can use
Deno Deploy:

1. Push your project to GitHub.
2. Create a Deno Deploy project.
3. Link the Deno Deploy
   project to the main.ts file in the root of the created repository.
4. The project will be deployed to a public $project.deno.dev subdomain.

For a more in-depth getting started guide, visit the
Getting Started page in the Fresh
docs.

Adding your project to the showcase


If you feel that your project would be helpful to other fresh users, please
consider putting your project on the
showcase. However, websites that are just for
promotional purposes may not be listed.

To take a screenshot, run the following command.

  1. ```sh
  2. deno task screenshot [url] [your-app-name]
  3. ```

Then add your site to
showcase.json,
preferably with source code on GitHub, but not required.

Badges


Made with Fresh

  1. ```md [![Made with Fresh](https://fresh.deno.dev/fresh-badge.svg)](https://fresh.deno.dev)
  2. ```

  1. ``` html
  2. <a href="https://fresh.deno.dev">
  3.    <img width="197" height="37" src="https://fresh.deno.dev/fresh-badge.svg" alt="Made with Fresh" />
  4. </a>
  5. ```

Made with Fresh(dark)

  1. ```md [![Made with Fresh](https://fresh.deno.dev/fresh-badge-dark.svg)](https://fresh.deno.dev)
  2. ```

  1. ``` html
  2. <a href="https://fresh.deno.dev">
  3.    <img width="197" height="37" src="https://fresh.deno.dev/fresh-badge-dark.svg" alt="Made with Fresh" />
  4. </a>
  5. ```