# Web Development Environment

A reproducible Nix Flake for modern web development.

This template provides a complete JavaScript and TypeScript development environment suitable for frameworks such as:

* React
* Next.js
* Svelte
* SvelteKit
* Vue
* Nuxt
* SolidJS
* Astro
* Express
* Fastify

## Included Software

### Runtime

* **Node.js 24**
* **npm**
* **pnpm**
* **Bun**

### Development Tools

* **TypeScript**
* **TypeScript Language Server**
* **Biome** (formatter and linter)
* **Prettier**

### Language Servers

* HTML
* CSS
* JSON
* TypeScript

These work automatically in editors supporting the Language Server Protocol (LSP), such as Neovim, Helix, Zed, VS Code, and Emacs.

## Usage

Enter the development environment:

```bash
nix develop
```

The shell prints the installed versions of Node.js, npm, pnpm, and Bun when it starts.

## Creating a Project

Examples:

### Vite

```bash
pnpm create vite
```

### Next.js

```bash
pnpm create next-app
```

### Astro

```bash
pnpm create astro
```

### SvelteKit

```bash
pnpm create svelte@latest
```

## Installing Dependencies

Using pnpm:

```bash
pnpm install
```

Using npm:

```bash
npm install
```

Using Bun:

```bash
bun install
```

## Formatting

Using Biome:

```bash
biome check .
biome format .
```

Using Prettier:

```bash
prettier --write .
```

## Project Layout

A typical project might look like:

```text
.
├── flake.nix
├── package.json
├── pnpm-lock.yaml
├── tsconfig.json
├── src/
└── public/
```

## Customization

Depending on your workflow, you may want to add additional tools, such as:

* Playwright
* Cypress
* Tailwind CSS
* Prisma
* Docker
* PostgreSQL client
* Redis client

Because the development environment is defined entirely by the flake, anyone can reproduce the same toolchain by running:

```bash
nix develop
```

without installing Node.js or any global packages manually.