• Routes = files. One file in routes becomes one URL. No config.
• DVE templates. Server-side views with variables, conditionals, loops, partials.
• Shared layout. Head, nav, footer as partials. Reuse everywhere.
• Session auth. Signed cookies guard the account page and switch the navbar.
• Form validation. Contracts check signup and login before the handler runs.
• Static assets. CSS and images in public folder, served at /assets.
• Deno only. No Node or bundler. UI from Bootstrap CDN.

Clone and run:

git clone https://github.com/NeaByteLab/Deserve-VE.git
cd Deserve-VE
deno install

Run the server:

deno task start

Open http://localhost:8000. All pages are server-rendered with DVE.

Development (watch):

deno task dev

Restarts when main.ts or routes/ change. For view/CSS changes, refresh the browser.

Every file in routes/ exports HTTP method handlers and maps to one URL.

main.ts registers session middleware once, so every handler reaches the session through context state:

router.use(Mware.session({ cookieSecret }))

• Read the current session with ctx.getState('session'). It is null for guests.
• Open a session with ctx.getState('setSession'), called after a valid login.
• Clear a session with ctx.getState('clearSession'), called on logout.

The navbar reads session to switch between Login/Sign Up and Account/Logout, and /account redirects to /login when no session exists.

Contracts live in schemas/ and run inside the POST handler with Validator.check. A failing contract throws, and the handler reads the reasons off error.cause to re-render the form with messages:

import { Validator } from '@neabyte/deserve'
import { loginContract } from '@schemas/login.ts'

// Throws when the form fails a rule
const data = Validator.check(loginContract, body as FormData)

Deserve-VE/
├── main.ts                 # Router, session, static, serve
├── deno.json               # Tasks, import aliases
├── public/
│   └── css/
│       └── style.css       # Sticky footer + overrides
├── schemas/
│   ├── login.ts            # Login form contract
│   └── signup.ts           # Sign up form contract
├── routes/
│   ├── index.ts            # Home
│   ├── about.ts            # About (conditional content)
│   ├── dashboard.ts        # Stats, table, list (complex DVE)
│   ├── items.ts            # List with #each
│   ├── hello.ts            # Minimal DVE
│   ├── signup.ts           # GET form, POST validate
│   ├── login.ts            # GET form, POST validate + session
│   ├── account.ts          # Session-guarded page
│   └── logout.ts           # POST clears session
└── views/
    ├── home.dve
    ├── about.dve
    ├── dashboard.dve
    ├── items.dve
    ├── hello.dve
    ├── signup.dve
    ├── login.dve
    ├── account.dve
    └── partials/
        ├── head.dve        # Meta, title, CSS
        ├── header.dve      # Navbar (session-aware)
        └── footer.dve      # Copyright (year from route)

Templates use Bootstrap 5 (CDN) for layout and components; narrative copy is lorem ipsum.

deno.json maps three folders so imports stay short:

• Deserve (JSR) - HTTP server, file-based routing, DVE rendering, session, validation, static middleware
• Deserve docs - Router, views, ctx.render(), session, validation, static

This project is licensed under the MIT license. See the LICENSE file for details.