A modern, type-safe web application for generating beautiful minimalist printable calendars and habit trackers. Built with Next.js, TypeScript, and Tailwind CSS.
- 🗓️ Minimalist Calendars: Generate clean, printable calendars for any year
- 📊 Habit Trackers: Create customizable habit tracking sheets
- 🌍 Multi-language Support: Available in 32 languages
- 📄 Multiple Formats: A4, A5, and Letter sizes in portrait/landscape
- 🎨 Beautiful Design: Clean, minimal aesthetic optimized for printing
- ♿ Accessible: ARIA labels, keyboard navigation, and screen reader support
- ⚡ Performance: Optimized with React.memo, error boundaries, and proper TypeScript
This project is a Turborepo monorepo with the following structure:
apps/frontend: Next.js web application for calendar preview and generationapps/generator: Puppeteer-based PDF generation serviceapps/robot: Placeholder for future automation tasks
packages/config: Shared configuration for locales, themes, and calendar settings
- Node.js 14+
- Yarn 1.22+
# Clone the repository
git clone <repository-url>
cd minimal
# Install dependencies
yarn install
# Copy environment variables
cp .env.example .env.local
# Start development server
yarn devCreate a .env.local file in the root directory:
# Required
SITE_URL=https://useminimal.comyarn dev # Start all apps in development mode
yarn build # Build all apps (includes sitemap generation)
yarn lint # Lint all apps
yarn format # Format code with Prettier
yarn test # Run all tests
yarn test:watch # Run tests in watch mode
yarn test:coverage # Run tests with coverage report
yarn generate # Generate calendar PDFs (requires frontend running)Frontend (apps/frontend):
cd apps/frontend
yarn dev # Start Next.js dev server
yarn build # Build for production
yarn test # Run Jest tests
yarn test:watch # Run tests in watch mode
yarn test:coverage # Run tests with coverageGenerator (apps/generator):
cd apps/generator
yarn generate # Generate calendar PDFsThe project includes comprehensive testing setup:
- Jest for unit testing
- React Testing Library for component testing
- Coverage reporting with thresholds
- Accessibility testing with jest-axe
# Run all tests across the monorepo
yarn test
# Run tests in watch mode
yarn test:watch
# Generate coverage report
yarn test:coverageThe application supports 32 languages:
English, French, German, Spanish, Italian, Portuguese, Polish, Latvian, Norwegian, Czech, Ukrainian, Croatian, Slovak, Slovenian, Thai, Danish, Dutch, Finnish, Icelandic, Hungarian, Romanian, Swedish, Turkish, Russian, Korean, Hindi, Greek, Persian, Arabic, Hebrew, Japanese, Chinese
- Frontend serves calendar previews at
http://localhost:3000 - Generator uses Puppeteer to capture calendar renders
- PDFs are generated for all supported languages and formats
- Output is organized and zipped for distribution
- Formats: A4, A5
- Orientations: Portrait, Landscape
- Types: Monthly calendars, Yearly overviews, Habit trackers
- Languages: 32 locales with proper date formatting
- Next.js 16 - React framework
- TypeScript - Type-safe development
- Tailwind CSS - Utility-first styling
- Radix UI - Accessible component primitives
- Luxon - Date manipulation and internationalization
- Turborepo - Monorepo build system
- ESLint - Code linting
- Prettier - Code formatting
- Jest - Testing framework
- React Testing Library - Component testing
- Puppeteer - PDF generation
- Vercel - Deployment platform
- Vercel Analytics - Performance monitoring
├── apps/
│ ├── frontend/ # Next.js web application
│ │ ├── src/
│ │ │ ├── components/ # React components
│ │ │ ├── pages/ # Next.js pages
│ │ │ ├── lib/ # Utilities and configuration
│ │ │ └── styles/ # Global styles
│ │ ├── __tests__/ # Test files
│ │ └── public/ # Static assets
│ ├── generator/ # PDF generation service
│ └── robot/ # Future automation
├── packages/
│ └── config/ # Shared configuration
├── .env.example # Environment variables template
├── turbo.json # Turborepo configuration
└── CLAUDE.md # AI assistant context
- Add locale configuration to
packages/config/config.ts - Test calendar rendering in all formats
- Update language list in README
- Create theme component in
apps/frontend/src/components/calendar/themes/ - Add theme to configuration
- Update theme lookup in print page
The application is optimized for Vercel deployment:
# Deploy to Vercel
vercel
# Or connect GitHub repository for automatic deployments# Build all apps
yarn build
# Deploy frontend app from apps/frontend/.next
# Deploy generator as serverless function or container- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- TypeScript: Strict mode enabled, no
anytypes - Testing: Write tests for new components and utilities
- Accessibility: Include ARIA labels and keyboard navigation
- Performance: Use React.memo and useMemo for expensive operations
- Security: No hardcoded secrets, validate all inputs
- Lighthouse Score: 95+ across all metrics
- Core Web Vitals: Optimized for LCP, FID, and CLS
- Bundle Size: Analyzed and optimized with tree shaking
- Error Handling: Comprehensive error boundaries
- Input Validation: All user inputs validated
- XSS Prevention: Proper escaping and sanitization
- CSRF Protection: Built-in Next.js protection
- Environment Variables: Secrets properly managed
- Dependencies: Regularly updated and audited
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ for the minimalist community