Skip to content

Have you contributed to Open-source? Now it's time to show off to the world!

License

Notifications You must be signed in to change notification settings

AndrewDineen/hacktobered.com

 
 

Repository files navigation

Hacktobered.com

I decided to build this fun project during Hacktoberfest 2022. Here are some details about its initial idea / problem statement, tech stack, how you can contribute, etc.

Initial Idea / Problem Statement

  • I am a developer and made (Or am planning to) open-source contributions during HacktoberFest.
  • Now, how can I share my hacktober achievements with others? Can I share via Instagram stories / WhatsApp Status / Twitter?
  • You can do it manually - copy and paste your PR links; create milestones and progress cards for social posts.
  • Is there any tool that simplifies the above manual steps?
  • Nope 😐!

Let us build then!

Proposed user flow

Basic User Flow

An easy task to pick up is creating more user cards like the one below:

cheerCard_small

Getting Started

  1. Install npm Dependencies:
npm i
# or
yarn
  1. Create .env.local file and copy content of .env.local.example.

  2. Create NEXTAUTH_SECRET - # Linux: openssl rand -hex 32 or go to https://generate-secret.now.sh/32

  3. Create Github OAuth App . Copy Client ID and Client Secret into GITHUB_ID and GITHUB_SECRET.

  4. If you want to save logged-in user details, you can use mongo db. Provide connection details in .env.local. However if you don't want - make sure to comment line 4 and line 14 in pages\api\auth[...nextauth].tsx before running the code.

     //import clientPromise from "../../../lib/mongodb";
      //adapter: MongoDBAdapter(clientPromise),
  5. Run the development server:

npm run dev
# or
yarn dev
  1. Open http://localhost:3000 with your browser to see the result.

Facing any issues? Feel free to open a ticket.

How to contribute

  • Drop a ⭐ on the Github repository (optional)

  • Before Contribute Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md

  • Create an issue of the project or a feature you would like to add in the project and get the task assigned for youself.(Issue can be any bug fixes or any feature you want to add in this project).

  • Fork the repo to your Github.

  • Clone the Repo by going to your local Git Client in a particular local folder in your local machine by using this command with your forked repository link in place of below given link:
    git clone https://github.com/<please write your git username here>/hacktobered.com.git

  • Create a branch using below command. git branch <your branch name>

  • Checkout to your branch. git checkout <your branch name>

  • Add your code in your local machine folder. git add .

  • Commit your changes. git commit -m "<add your message here>"

  • Push your changes. git push --set-upstream origin <your branch name>

  • Make a pull request! (compare your branch with the owner main branch)

Tech Stack:

  • React, Next.js, Typescript
  • Chakra UI component library
  • Next-Auth
  • (Optional) MongoDB - if you want to save user details.

Our Amazing Contributors



Show some ❤️ by starring this awesome repository!

About

Have you contributed to Open-source? Now it's time to show off to the world!

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 97.9%
  • CSS 2.0%
  • JavaScript 0.1%