No description

Nix 66%
Rust 23.7%
CSS 10.1%
Python 0.2%

Find a file

municorn 8b3a1ffa1b feat(templates): add dioxus fullstack template add a new comprehensive Dioxus fullstack template with support for web, desktop, and mobile platforms. includes shared UI components, server functions, and development environment configuration with Nix and devenv. - multi-platform workspace structure (web, desktop, mobile) - shared UI crate with Hero, Navbar, and Echo components - API crate with server function examples - fullstack routing and state management - development environment with PostgreSQL and Redis services - Nix-based build system for production deployments - comprehensive documentation for each platform		2026-06-17 12:34:53 -07:00
modules	refactor(oxfmtrc): simplify sortImports config and add printWidth	2026-06-05 09:55:58 -06:00
templates	feat(templates): add dioxus fullstack template	2026-06-17 12:34:53 -07:00
.gitignore	chore(templates): ignore nix build result directory	2026-03-28 23:44:33 -06:00
devenv.lock	chore(devenv): update lock file dependencies	2026-06-16 17:11:17 -07:00
devenv.nix	fix(devenv): change cachix configuration from pull to push	2026-05-11 16:08:00 -07:00
devenv.yaml	docs(devenv): add descriptive comments to flake inputs	2026-04-29 16:14:29 -06:00
flake.nix	feat: change default template to `basic`	2026-03-15 22:50:39 -06:00
LICENSE	chore: add MIT license	2026-02-12 08:06:58 -07:00
README.md	docs: update hook name from commitlint-rs to cocoa-lint	2026-03-22 09:26:20 -06:00

README.md

musicaloft-shell

This is the standardized Musicaloft code style for consistent formatting and development practices across all Musicaloft projects.

This repository is open for you to use on your own projects as well!

Overview

musicaloft-shell provides a devenv module for consistent development environments across projects.

Features

Code formatters

Automatically formats code using treefmt with the following tools:

kdlfmt - KDL formatting
nixfmt - Nix code formatting
oxfmt - TypeScript and JavaScript formatting
ruff-check - Python linting
ruff-format - Python formatting
rustfmt - Rust code formatting
sqruff - SQL formatting
taplo - TOML formatting

Git hooks

Pre-commit hooks powered by git-hooks-nix:

Universal hooks

treefmt - Automatically formats staged files before commit
cocoa-lint - Validates commit messages using conventional commit format

Rust projects

clippy - Lints Rust code with all features enabled, denying warnings

TypeScript projects

oxlint - Type-aware linting with warnings treated as errors

Python projects

ruff - Lints Python code
ruff-format - Formats Python code
ty - Type-checks Python code

Commit message format

type(scope): description under 72 characters

Allowed types:

Type	Description
`build`	Changes the build process
`chore`	Doesn't affect source code
`ci`	Affects CI/CD pipelines
`docs`	Affects comments or documentation
`dx`	Improves or changes developer experience
`feat`	Adds a new user-facing feature
`fix`	Introduces a user-facing bug fix
`perf`	Improves performance
`refactor`	Changes source code without a new feature or fix
`revert`	Reverts a previous commit
`style`	Changes how code or documents are formatted
`test`	Changes or adds automated testing

Rules:

Description must be lowercase
Maximum 72 characters
Scope maximum 10 characters (warning)

Usage

In devenv.yaml:

inputs:
  musicaloft-shell:
    url: github:musicaloft/musicaloft-shell
    flake: false

    # optional
    inputs:
      nixpkgs:
        follows: nixpkgs

  # you may need to add these dependencies and more, depending on your project
  git-hooks:
    url: github:cachix/git-hooks.nix
    inputs:
      nixpkgs:
        follows: nixpkgs
  treefmt-nix:
    url: github:numtide/treefmt-nix
    inputs:
      nixpkgs:
        follows: nixpkgs

# import the module
imports:
  - musicaloft-shell

And that's it!

Setup

# clone the repository
git clone git@git.musicaloft.com:musicaloft/musicaloft-shell.git
cd musicaloft-shell

# allow direnv for automatic environment loading
direnv allow

# or manually enter the development shell
devenv shell

License

See LICENSE for details.