This is the Front-end base project in Next.js for the Software and Systems Engineering discipline, offered by the Informatics Center (CIn) of the Federal University of Pernambuco (UFPE).
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
To run this project, you'll need to have the following software installed on your system:
- Node.js
- npm (Node Package Manager)
Clone the repository and install the dependencies by running the following command in the project directory:
npm install
To start the app, run the following command:
npm run dev
This command will run the Next app in development with Next.js script. You can acess the app in the following URL: http://localhost:3000
There is one type of test configured in the base project: E2E acceptance tests using Playwright with Cucumber.
To run E2E tests:
npx cucumber-js
The following scripts are available in the package.json file:
dev: Runs the app in development mode.build: Compiles the TypeScript code.start: Starts the app in production mode.lint: Runs ESLint on your code.
The following dependencies are used in the project:
- Next.js: Used by some of the world's largest companies, Next.js enables you to create full-stack Web applications by extending the latest React features, and integrating powerful Rust-based JavaScript tooling for the fastest builds.
- React: React is a JavaScript library for building user interfaces.
- Shadcn/ui: Beautifully designed components that you can copy and paste into your apps. Accessible. Customizable. Open Source.
- Lucide Icons: Beautiful & consistent icons Made by the community.
- react-hook-form: React Hook Form is a library for React that simplifies form validation and input data handling.
- zod: Zod is a TypeScript-first schema declaration and validation library. I'm using the term "schema" to broadly refer to any data type, from a simple string to a complex nested object.
To understand and learn more details about the structure of the project, click here to be redirected to the README that contains this information.