/next-starter-peacock

🦚 Beautiful Nextjs starter for software engineers and designers to show work they're so proud of

Primary LanguageTypeScriptMIT LicenseMIT

Next Starter Peacock

🦚 Next Starter Peacock

Peacock is a NextJS portfolio Starter for software engineers and designers. Showcase your awesome work and build personal sites you're proud of.

Features

  • Styled with EmotionJSπŸ’…πŸΎ
  • Written in TypeScript βš›
  • Blog, Notes and Work content types πŸ–Š

Getting Started

  1. Fork the project. (It's highly recommended to fork the project to get upcoming features and bug fixes)

  2. Clone your fork

git clone https://github.com/<your-username>/next-starter-peacock.git
  1. Jump into the directory and Install dependencies
cd next-starter-peacock && yarn

or

cd next-starter-peacock && npm install
  1. Start the dev server
yarn dev

or

npm run dev
  1. Find config/index.json, change name and title to your name and title. Save and open http://localhost:3000 with your browser πŸ’₯πŸ’₯πŸ’₯. See the results 😊.

Customize Peacock

Peacock ships with 3 basic content types

  • Articles: Long form content. Think blog posts πŸ“š. All articles are in the /content/articles folder. Any markdown document you add here will show on the /articles page.
  • Notes: Short form Spontaneous content πŸ–‹. All notes are in the /content/notes folder.
  • Works: Case studies and projects you want to show πŸ› . All works are in the /content/works folder. There's a selectedWork field in the markdown meta. Setting it to true will display the case study/work on the index.tsx page.

Deploy to Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

Contributing

The best way you can contribute to peacock is by creating issues, reporting bugs and propose new features. If you're kind enough and have extra time, you can help on some features. Here's the simple workflow

  • Open issue to see if the feature is already worked on
  • Get go ahead to work on feature if it's not taken
  • Fork next-starter-peacock
  • Create your branch and do your magic
  • Send pull request
  • Pull request is merged

The fastest way to get an answer to your question is to reach out via Twitter. Feel free to through a tweet or DM.

Todo

  • Test rendering and styling of standard HTML elements
  • Replace personal portfolio content with demo content
  • Add simpler notes page
  • Image optimization (Fixed image heights to avoid layout janks)
  • Release V1
  • Add page transitions with react-spring
  • Add mdx support
  • Code syntax highlighting