Skip to content

DaveBitter/pomodoro

Repository files navigation

Pomodoro

Netlify Status

Pomodoro is a neumorphic Pomodoro/Timer to help you stay on track!

screenshot of the pomodoro timer

Demo

You can try Pomodoro out yourself at pomodoro.davebitter.com or look at the individual components at pomodoro.davebitter.com/components.

Getting started

Pomodoro was bootstrapped with Next.js. Please, read the docs to get up to speed with how pages, routing, server-side functions and more works.

Run development environment

yarn dev or npm run dev - starts the development environment with auto reloading and all that good stuff. Open http://localhost:3000 to view it in the browser.

Scripts

Besides the development script, there are many more scripts set up:

  • build - Creates build
  • export - Creates export
  • deploy - Creates build and export
  • storybook - Starts the development environment for storybook
  • storybook:build - Builds the storybook for production to be hosted by you
  • test - Runs the Jest and Enzyme test suite
  • test:watch - Runs the Jest and Enzyme test suite in watch mode
  • test:coverage - Runs the Jest and Enzyme test suite and shows test coverage
  • eslint - Runs ESLint for all TypeScript files
  • stylelint - Runs Stylelint for all SCSS files

Tech stack

Next.js

Pomodoro uses Next.js to

  • provide SSR and SSG React.js. Pages are automatically optimised to deliver the best experience.
  • handle routing
  • generate builds
  • and more

TypeScript

Pomodoro used TypeScript for static checking and documentation. You can view the Typescript config in ./tsconfig.json.

Jest and Enzyme

Pomodoro uses Jest and Enzyme as the testing suite. All tests can be found in the component and utilities folders with .test. postfix. As you may notice, we don't import Jest and Enzyme in the test files. Some things are setup in config/tests. Next to that, mock content and components can be found in config/tests/mocks.

Storybook

Pomodoro uses Storybook for showcasing components. Storybook has its own webpack configuration. You can find this configuration in .storybook/webpack.config.js together with all other Storybook specific items.

Husky, ESLint, StyleLint and LintStaged

Pomodoro uses Husky to automatically run ESLint, Stylelint, LintStaged and the test suite for every commit. This is done by using the precommit script found in package.json. Never run --no-verify as you don't want to ignore these settings. If you have an issue with the config, please update the config file of that linter accordingly.