Netcs

Overview:

Netcs is a Next.js and Contentful starter project for building personal websites easily. It aims to provide a consistent and flexible way to start a project while addressing common issues encountered when working with Contentful and Next.js. The project incorporates various features and utilizes React SSR in Next.js and Contentful’s content modeling capabilities.

Features:

• Flexible and composable content models
• SEO-ready with metadata generated based on specific fields
• Generation of GraphQL schema and types in sync with content types
• Typescript support
• Tailwind CSS integration via DaisyUI
• Next.js SSR components
• Contentful Live preview

Installation:

To get started with Netcs, you will need the following requirements:

• Access to a Contentful space (register for free at https://www.contentful.com/get-started/)
• Optionally, Turso DB for newsletter signups and article views counter
• Node 18+ and pnpm installed in your environment

Follow these steps to install Netcs:

1. Clone the repo.
2. Install dependencies using pnpm.
3. (Optional) If you want article view counts and newsletter registration:
   • Create a Turso database.
   • Get an Auth token.
   • Place the Turso database URL and auth token in your .env file.
   • Run the migration command and push the migrations.
4. Import example data into Contentful:
   • Ensure you have an empty environment without any content models created.
   • Install the 2 required Contentful Apps mentioned when running the import command.
   • Note that the migration data uses the default Contentful locale en-US. If you want a different locale, you will need to manipulate the exported data.
5. Start the local server by running [command].

Summary:

Netcs is a Next.js and Contentful starter project that offers a consistent and flexible way to start building personal websites. It addresses common issues encountered when working with Contentful and Next.js and provides features such as flexible content models, SEO readiness, GraphQL schema generation, Typescript support, Tailwind CSS integration, and more. The installation guide provided helps users get started with the project and set up their environment correctly.