next-enterprise/README.md

Document Upload App with Next.js

This project is built on the robust foundation of the Next.js Enterprise Boilerplate by Blazity, tailored for a document upload application. It demonstrates advanced usage of Next.js, Formik for form management, Tailwind CSS for styling, and includes comprehensive testing with Jest and Playwright. This README guides you through the project setup, features, and deployment.

Features

• Next.js: Leveraging the latest features of Next.js for SSR and static generation.
• Tailwind CSS: Utilizing Tailwind for rapid and responsive UI development.
• Formik: Streamlined form handling with validation and custom input components.
• Playwright: End-to-end testing to ensure reliability and functionality.
• Radix UI: Utilizing Radix UI for accessible and customizable components.
• Tailwind Merge: Efficiently managing Tailwind CSS classes.
• TypeScript: Ensuring type safety and developer productivity.

Getting Started

To run this project locally, follow these steps:

1. Clone the repository:

git clone https://github.com/vasquezjesus2710/next-enterprise
cd next-enterprise

2. Install Dependencies

yarn install

3. Start the development server

yarn dev

Visit http://localhost:3000 to view the application.

Project Structure

• components/: Reusable UI components, including custom Formik inputs.
• pages/: Application pages and the API endpoint for form submission.
• public/: Static assets like images and fonts.
• styles/: Global styles and Tailwind configuration.
• tests/: Jest unit tests and Playwright end-to-end tests.
• utils/: Utility functions and helpers.

Testing

This project includes both unit and integration tests with Jest and end-to-end tests with Playwright:

• Run unit and integration tests: yarn test

• Run end-to-end tests:

yarn e2e:headless # For headless testing
yarn e2e:ui # For UI testing

Acknowledgments

Built on the Next.js Enterprise Boilerplate by Blazity.