Installation

INSTALLATION

Follow these steps to install, configure, and run the TechCore Next.js template locally or in production.

1. Requirements

  • Node.js: Use Node.js 24.x, as documented for this package. Check the current Next.js system requirements and your hosting provider for compatibility before deployment. Confirm compatibility with your deployment platform.
  • npm, included with Node.js.
  • A terminal or command prompt.

2. Install Dependencies

  • Extract the downloaded template package.
  • Open a terminal in the project root directory containing package.json.
  • Install the dependencies:
npm install

3. Environment Setup

Check the project root for an .env.example file. If one is included, copy it to .env.local and configure the variables required by the features you use.

# Windows PowerShell
Copy-Item .env.example .env.local

# macOS / Linux
cp .env.example .env.local

If the package does not include an .env.example file, create one only after identifying the environment variables actually used by the project. Do not add placeholder variables that the application does not use.

For optional Mailchimp integration, configure NEXT_PUBLIC_MAILCHIMP_URL in .env.local only if the relevant component implements that integration. Use your actual Mailchimp subscription endpoint. The variable alone does not enable form submission.

Restart the development server after changing environment variables. Never put private API keys in variables prefixed with NEXT_PUBLIC_.

4. Run the Development Server

Start the local development server:

npm run dev

Open http://localhost:3000 in your browser.

5. Create a Production Build

Generate an optimized production build:

npm run build

6. Start the Production Server

After the production build completes successfully, run:

npm run start

The production site will normally be available at http://localhost:3000.

7. Important Notes

  1. Run commands from the project root directory containing package.json.
  2. Run npm run build again after making changes before testing the production server.
  3. The Contact, Message, Coming Soon, FAQ, and Blog Comment forms are demo-only layouts unless you connect them to a real backend or service.

8. Production Deployment

Deploy the project to a hosting platform that supports the required Next.js runtime. Configure any required environment variables in the hosting platform before starting the application.

For production, run npm run build and then npm run start according to your hosting provider's deployment instructions. Static hosting requires separate verification that the project supports static export.