Skip to content

OlushesiToheeb/nextjs14-typescript-starter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Next.js 14 TypeScript Starter

Welcome to the Next.js 14 TypeScript Starter project! This repository is a boilerplate for Next.js 14 applications using TypeScript, integrating several advanced features and tools to kickstart your development.

Features

This starter kit includes the following technologies:

  • Next.js 14 with the App Router
  • TypeScript: Static type checking
  • Redux & Redux-Persist: State management and persistence
  • Tailwind CSS: Utility-first CSS framework
  • Sass: CSS pre-processing
  • Docker: Application containerization
  • Jest: Unit testing
  • Playwright: End-to-end testing
  • React Hook Form: Efficient form management
  • ESLint & Prettier: Code linting and formatting
  • Yup: Schema validation for forms
  • lint-staged: Running linters on git staged files

Getting Started

Prerequisites

Ensure you have Node.js version 14.x or higher installed. Docker is optional but recommended for containerization.

Installation

To set up the project locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/OlushesiToheeb/nextjs14-typescript-starter.git
    cd nextjs14-typescript-starter
  2. Install dependencies:

    npm install

Running the App

To run the application in development or production environments, use the following commands:

  1. Development mode:

    npm run dev
  2. Production mode:

    Build and start the application:

    npm run build
    npm start

Docker Usage

To build and run the application using Docker, execute:

docker build -t nextjs14-typescript-starter .
docker run -p 3000:3000 nextjs14-typescript-starter

Testing

Run unit and end-to-end tests using:

  1. Unit tests with Jest:

    npm run test
  2. End-to-end tests with Playwright:

    npm run test:e2e

Linting and Formatting

Ensure your code meets the coding standards with:

  1. Linting:

    npm run lint
  2. Formatting:

    npm run format

Husky and lint-staged

Husky and lint-staged are configured to run linters on git staged files to ensure code quality before commits.

Contributing

Contributions to improve the starter kit are highly welcomed. Please feel free to fork the repository, make your changes, and submit a pull request.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published