Deno-Fresh — Vite Starter Template

SHA-256: 1087ccd18108f2e1a5837bcda416b8e08a69273d84047a95b1f62a8ed9c9a24f

2026-10-16T16:06:08.941Z

# Deno Fresh Starter [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

A minimal, typed Fresh (Deno) starter focused on clarity, DX, strict rules, and modern defaults. It includes a small example of middleware, islands with signals, typed helpers via a factory, and ergonomic path aliases.

## Built-in Integrations

- [Redis](docs/REDIS.md) - Service with caching, JSON operations, and atomic counters.

## Installation

```bash
git clone https://github.com/NeaByteLab/Deno-Fresh.git
cd Deno-Fresh/
```

## Quick start

```bash
# Start the dev server
deno task dev

# Production build
deno task build

# Run the built server
deno task start

# Keep Fresh up-to-date
deno task update
```

## Project structure

```text
src/
├─ assets/
│  └─ styles.css         # Global styles imported by client.ts
├─ components/
│  └─ Button.tsx         # Reusable UI component
├─ islands/
│  └─ Counter.tsx        # Interactive island using @preact/signals
├─ routes/
│  ├─ api/
│  │  └─ [name].tsx      # Example API route (/api/:name)
│  ├─ _app.tsx           # Document shell (html/body)
│  ├─ _error.tsx         # Error boundary with common HTTP codes
│  └─ index.tsx          # Home page (+ example island)
├─ client.ts             # Client entry (loads global CSS)
├─ main.ts               # Exposes typed `define` and `State`
├─ server.ts             # App wiring: middleware, static files, fs routes
```

Other root files:

- `_fresh/` — generated output after build/dev (ignored from tooling)
- `deno.json` — imports, tasks, compiler options, lint/format config
- `vite.config.ts` — Vite integration

## Troubleshooting

### Fresh Hydration "x is not defined" Error

If you encounter hydration errors like `n is not defined` or `r is not defined`, this is typically caused by corrupted build cache. To fix:

```bash
rm -rf _fresh node_modules/
deno install --allow-scripts
```

> Reference: [Fresh Troubleshooting Guide](https://fresh.deno.dev/docs/advanced/troubleshooting#install-or-re-install-dependencies)

### Common Issues

1. **Module resolution errors** - Clear build cache with `rm -rf _fresh`
2. **Import path issues** - Ensure `@app/` alias is properly configured in `deno.json`
3. **Signal serialization** - Fresh handles signal serialization automatically

## Official documentation

For the full Fresh documentation, guides, and API reference, see the official site:

- Getting Started: https://fresh.deno.dev/docs/getting-started
- Introduction: https://fresh.deno.dev/docs/introduction

## License

MIT License - see [LICENSE](LICENSE) file for details.