Skip to content
typescript-nix-template

typescript-nix-template

Production-ready TypeScript monorepo with Nix development environments, Bun workspaces, and automated semantic versioning
Getting started View on GitHub

Features

Section titled “Features”

Nix development environments

Reproducible development environments with all tools managed by Nix flakes. No manual installation needed.

Bun workspaces

Fast monorepo package management with Bun workspaces. Shared dependencies and efficient builds.

Automated versioning

Semantic-release automation with conventional commits. Automated changelog generation and GitHub releases.

Comprehensive testing

Vitest for unit tests, Playwright for E2E. Type-safe testing patterns throughout.

CI/CD ready

GitHub Actions workflows for testing and deployment. Cloudflare Workers deployment included.

Secrets management

SOPS with age encryption for secure secrets. Git-committed encrypted secrets with key rotation support.

Quick start

Section titled “Quick start”
Terminal window
# Clone and setup
git clone https://github.com/sciexp/typescript-nix-template.git
cd typescript-nix-template
nix develop
bun install


# Start development
just dev

See Getting started guide for complete setup instructions.

Using as a template

Section titled “Using as a template”

This repository serves dual purposes:

  1. Working deployment - Live example at ts-nix.scientistexperience.net
  2. Forkable template - Starting point for your TypeScript projects

See Template usage guide for customization instructions.

Documentation structure

Section titled “Documentation structure”
  • Guides - Step-by-step instructions for common tasks
  • Reference - Technical details and architecture decisions

Next steps

Section titled “Next steps”