Skip to content

Seed is a general purpose blogging app with blazing fast page renders by utilizing SSG and it also keep your content up to date with ISR. The deployed version utilizes Seed as a Software Engineering blog but you can customize it for your usecase.

License

Notifications You must be signed in to change notification settings

AbdulAhadSiddiqui11/seed

Repository files navigation

Welcome to Seed πŸ‘‹

TypeScript Next JS React GraphQL TailwindCSS SASS Google Vercel

Seed is deployed and live, click here and check it out now!

Seed Home

Seed is a general purpose blogging app with blazing fast page renders by utilizing SSG and it also keep your content up to date with ISR. The deployed version utilizes Seed as a Software Engineering blog but you can customize it for your usecase

Features:

  • Modern & Responsive Design : Seed comes with beautiful modern design with fully responsive layout which results in an amazing UX

  • Dynamic Routing : Seed will create dynamic routes to new blogs or categories you add from your CMS

  • Static Site Generation : All blog posts will be static in nature, meaning they don't require client side async API calls or server side processing to render, these pages are cached and served blazing fast directly from a CDN. One more benefit to static pages is, they are SEO friendly.

  • Incremental Static Site Regeneration : Seed will revalidate the static pages on each request and update the content as needed. This will make sure users are always seeing latest content while enjoying super fast page loads

  • Client Side Data Fetching : Components like "Related posts" on the side-bar will fetch data in real time to promote specific posts. This way most of the page still remain static

  • Unlimited Authors, Posts and Categories : There is no limit the number of authors, post or categories you want to publish onto Seed

  • Comments Moderation : All readers can submit comments, but they will only be published for public view after your approval

  • Google Analytics : Monitor site activity with Google Analytics

Tech. stack

Front-end stack

Back-end stack

  • Next.js : API endpoints, Static Site Generation (SSG), Incremental Static Site Regeneration (ISR), & Client-Side Data Fetching
  • HyGraph : Datastore / Headless CMS

Installing locally

Setting up HyGraph CMS

  • Create a Graph CMS project with schema provided.
  • Check out HyGraph documentation for a step by step guide
  • Once you have your HyGraph CMS ready, fill in your env. varilables and proceed with the next steps
  • You can use Strapi or any other CMS in place of HyGraph and host it yourself

Setting up dev. environment variables

  • Create a new file .env.development under ./ and fill the following three variables
NEXT_PUBLIC_GRAPHCSM_ENDPOINT = < YOUR CMS ENDPOINT >

NEXT_PUBLIC_GRAPHCSM_TOKEN = < YOUR CMS AUTH. TOKEN >

NEXT_PUBLIC_GA_MEASUREMENT_ID = < YOUR GOOGLE ANALYTICS MEASUREMENT ID >

Installing dependencies

  • Use the following command in your terminal from ./ to install project dependencies
npm install
< or >
yarn install
< or >
pnpm install

Starting the development server

  • After you have installed dependencies, use the following command in your terminal from ./ to start the dev. server
npm run dev
< or >
yarn dev
< or >
pnpm dev
  • Visit http:https://localhost:3000 to view Cacta on your local machine

Build & Deploy

Environment variables

  • Update the evniornment variables on your hosting platform before building
NEXT_PUBLIC_GRAPHCSM_ENDPOINT = < YOUR CMS ENDPOINT >

NEXT_PUBLIC_GRAPHCSM_TOKEN = < YOUR CMS AUTH. TOKEN >

NEXT_PUBLIC_GA_MEASUREMENT_ID = < YOUR GOOGLE ANALYTICS MEASUREMENT ID >

Build command

  • Use the following commands for building and deploying
npm run build
< or >
next build

Install command

npm install
< or >
yarn install
< or >
pnpm install
  • Congratulations your Seed app is up and running!

Author

πŸ‘€ Abdul Ahad Siddiqui

🀝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!

πŸ“ License

Copyright Β© 2023 Abdul Ahad Siddiqui.
This project is MIT licensed.

About

Seed is a general purpose blogging app with blazing fast page renders by utilizing SSG and it also keep your content up to date with ISR. The deployed version utilizes Seed as a Software Engineering blog but you can customize it for your usecase.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published