The Code of Music

The Code of Music is an interactive handbook that teaches readers how to create musical systems with code, in the browser. It will be available in website and PDF formats.

Setup

Configure npm registry access for the interactive sketches:

# Create a .npmrc file in the project root with the following content:
@luisaph:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN

Development

# Install dependencies:
yarn install
# Start the development server:
yarn dev

Production Build

# Build the project (includes generating PDF):
yarn build

# Generate PDF only:
yarn build:pdf

# Preview the built site:
yarn preview

Project Structure

• /src/ - Source code
  • /src/components/ - React/Astro components
  • /src/pages/ - Astro pages
  • /src/layouts/ - Layout components
  • /src/styles/ - CSS styles
  • /src/content/ - Book Content (MDX, images...)
• /public/ - Static assets
• /scripts/ - Build and utility scripts