A project to standardize and normalize stylesheets used in digital books, following guidelines on usability and accessibility for the visually impaired and dyslexics.
This repository contains SCSS stylesheets designed for digital books with a focus on accessibility and usability for users with visual impairments and dyslexia. The project includes comprehensive styling for various content types including braille, e-books, EPUB, and HTML formats.
- Accessibility-focused: Designed with guidelines for visually impaired and dyslexic users
- Multiple formats: Support for braille, e-books, EPUB, and HTML
- Modern tooling: Built with Vite for fast development and optimized builds
- Bootstrap integration: Includes Bootstrap 5 components and utilities
- Comprehensive styling: Covers book structure, typography, tables, lists, and more
-
Clone the repository:
git clone https://github.com/nlbdev/nlb-scss.git cd nlb-scss -
Install dependencies:
pnpm install
- Development build:
pnpm run build:css - Production build (minified):
pnpm run build:css:min - Full build:
pnpm run build(builds both development and production versions) - Watch mode:
pnpm run dev(automatically rebuilds on file changes) - Preview:
pnpm run preview(serves the built files locally)
src/scss/
├── braille/ # Braille-specific styles
├── includes/ # Shared mixins and utilities
│ ├── bootstrap/ # Bootstrap components
│ └── _*.scss # Core utilities
├── *.scss # Main entry points for different formats
└── variables.scss # Global variables
- Fork the repository
- Create a feature branch
- Make your changes
- Test your changes with
pnpm run dev - Submit a pull request
This repository automatically builds when pull requests are merged to the main branch.
MIT License - see LICENSE file for details.