Creating a New Next.js Project

First, you’ll need to have Node.js and npm installed on your system. If you don’t have them yet, you can download them from the official Node.js website.

Once you’ve confirmed that Node.js and npm are installed correctly, you can create a new Next.js project using the create-next-app command, which is the official command for new Next.js projects.

Open a terminal and run the following command to create a new project:

Desculpe pela confusão anterior. Aqui está a seção revisada com a explicação da flag --ts inserida no local correto:

npx create-next-app@latest my-app

In this command, my-app is the name of your new project. You can replace my-app with any name you want for your project. The npx command is a tool that comes with npm, the Node.js package manager. It is used to run Node.js packages that are installed locally in your project or are available remotely on the npm registry.

create-next-app is a package available on the npm registry that sets up a new Next.js project for you. It takes care of all the initial setup, such as creating the project directory, installing necessary dependencies, and configuring basic files.

@latest is a tag specifying that you want to use the latest version of the create-next-app package. This ensures you’re always using the most updated version and, consequently, have access to the latest features.

If you want to create a new Next.js project with TypeScript, you can add the --ts flag to the command:

npx create-next-app@latest my-app --ts

The --ts flag is an option you can add to the create-next-app command to create a new Next.js project with TypeScript support.

Configuring Port 80

Port 80 is the default port for HTTP traffic. To host a Next.js website on Square Cloud, it’s crucial to configure the use of port 80. In Next.js, you can set the -p 80 parameter in the startup script to ensure your website runs correctly on this port.

Creating the Configuration File on Square Cloud

Square Cloud requires a specific configuration file to host your website. You can access our step-by-step guide on how to create one: How to create your Square Cloud configuration file

Configuring the START Field

In the Square Cloud configuration file, the START field is essential for customizing the startup command. If you want to build and start your website on Square Cloud, configure the START field as follows:
START=npm run build && npm run start

This command will execute the “build” and “start” scripts defined in your package.json:

  "name": "my-app",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start -p 80",
    "lint": "next lint"
  "dependencies": {
    "react": "^18",
    "react-dom": "^18",
    "next": "14.1.0"
  "devDependencies": {
    "autoprefixer": "^10.0.1",
    "postcss": "^8",
    "tailwindcss": "^3.3.0",
    "eslint": "^8",
    "eslint-config-next": "14.1.0"

Uploading Your Website to Square Cloud

After following all the steps, place your website files inside the zip where the configuration file is, and upload the site at Upload. Remember not to include files like package-lock.json or node_modules. You can get more information about unnecessary files when hosting at automatic-deletion-files-when-deploying-an-application-to-squarecloud.


Additional Resources

For more information about Next.js and its tools, visit the official Next.js documentation. There, you’ll find detailed guides, tutorials, and API documentation to help you make the most of Next.js.

If you continue to experience any issues, please don’t hesitate to contact our support team.