Skip to content

GITHUB_SETUP_GUIDE.md

Latest commit

 

History

History
443 lines (328 loc) · 11 KB

GITHUB_SETUP_GUIDE.md

File metadata and controls

443 lines (328 loc) · 11 KB
Raw

🚀 How to Push This to GitHub

Complete step-by-step guide for uploading your NotebookLM Prompts repository to GitHub.

Prerequisites

Before you start, make sure you have:

  • ✅ GitHub account (create at github.com if needed)
  • ✅ Git installed on your computer (git-scm.com)
  • ✅ All repository files downloaded from this session

Step-by-Step Guide

Step 1: Create a New Repository on GitHub

  1. Go to GitHub → github.com/new

  2. Create a new repository:

    • Repository name: awesome-notebooklm-prompts
    • Description: "A comprehensive collection of 150+ NotebookLM prompts for creating stunning presentation slide decks"
    • Visibility: Public (so others can discover it)
    • Initialize with: DO NOT check "Add a README file" (we have one)
    • Click Create repository

  3. Copy your repository URL

    • You'll see a URL like: https://github.com/YOUR-USERNAME/awesome-notebooklm-prompts.git
    • Keep this handy for the next step

Step 2: Prepare Your Local Files

  1. Create a folder on your computer:

    mkdir awesome-notebooklm-prompts
cd awesome-notebooklm-prompts

  2. Copy all downloaded files into this folder:

    awesome-notebooklm-prompts/
├── README.md
├── CONTRIBUTING.md
├── LICENSE
├── RESOURCES.md
├── .gitignore
├── notebooklm_complete_prompts.md
├── notebooklm_quick_reference.md
└── examples/
    ├── academic-conference-presentation.md
    └── investor-pitch-deck.md

  3. Make sure all files are in place:

    ls -la
# Should show all files listed above

Step 3: Initialize Git & Push

Option A: Using Command Line (Recommended for most)

  1. Open terminal/command prompt in the folder

    cd awesome-notebooklm-prompts

  2. Initialize Git:

    git init

  3. Add all files:

    git add .

  4. Create first commit:

    git commit -m "Initial commit: Add complete NotebookLM prompts library with 150+ prompts"

  5. Add remote repository (replace with YOUR URL):

    git remote add origin https://github.com/YOUR-USERNAME/awesome-notebooklm-prompts.git

  6. Verify the remote was added:

    git remote -v
# Should show your URL

  7. Push to GitHub:

    git branch -M main
git push -u origin main

  8. Enter your GitHub credentials when prompted

    • Username: Your GitHub username
    • Password: Your GitHub personal access token (not your regular password)

    Get a Personal Access Token:

    • Go to github.com/settings/tokens
    • Click "Generate new token"
    • Select scopes: repo (full control of private repositories)
    • Copy the token and use it as your password

  9. Done! 🎉

    # Go back to GitHub to verify it worked
# You should see all files at: github.com/YOUR-USERNAME/awesome-notebooklm-prompts

Option B: Using GitHub Desktop (Easier for beginners)

  1. Download GitHub Desktop: desktop.github.com

  2. Install and sign in with your GitHub account

  3. Create new repository:

    • File → New Repository
    • Name: awesome-notebooklm-prompts
    • Local path: Choose the folder where your files are
    • Click Create

  4. Add files:

    • The files should auto-populate
    • GitHub Desktop shows "Changes" tab
    • Type commit message: "Initial commit: Add complete NotebookLM prompts library"
    • Click Commit

  5. Publish to GitHub:

    • Click "Publish repository" button
    • Make it public (optional but recommended)
    • Click Publish

  6. Done! 🎉

Step 4: Verify Your Repository

  1. Go to GitHub:

    https://github.com/YOUR-USERNAME/awesome-notebooklm-prompts

  2. Check that you see:

    • ✅ README.md displaying nicely
    • ✅ All files in the root folder
    • ✅ examples/ folder with 2 files
    • ✅ File counts: 7 markdown files total

  3. Make sure the README renders properly

    • GitHub should show your README at the bottom of the repository page
    • All headings, links, and formatting should look good

Next Steps After Publishing

1. Add Badges to Your README

GitHub badges show off your repo! Add these to the top of your README:

[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](CONTRIBUTING.md)
[![Stars](https://img.shields.io/github/stars/YOUR-USERNAME/awesome-notebooklm-prompts?style=social)]()

Just edit README.md on GitHub and replace YOUR-USERNAME with your actual username.

2. Create Topics (Labels)

Help people discover your repository:

  1. Go to your repository settings
  2. Under "Topics", add:
    • notebooklm
    • prompts
    • presentation
    • ai-tools
    • awesome-list
    • gemini

3. Add to Awesome Lists

Now that you have a great repository, you can add it to existing awesome lists:

  1. Find "awesome" lists related to NotebookLM or prompts
  2. Fork the repository
  3. Add your repository to the list
  4. Submit a pull request

Popular awesome lists to add to:

4. Share Your Repository

Tell people about your work:

Share on:

  • Twitter/X: Just published "awesome-notebooklm-prompts" - 150+ field-tested prompts for creating stunning decks with NotebookLM 🚀
  • LinkedIn: Post about your resource and why you created it
  • Reddit: Share in r/notebooklm
  • Discord: Share in NotebookLM communities
  • Email: Send to interested communities

Example Tweet:

Just published awesome-notebooklm-prompts 🎨

150+ field-tested prompts for creating stunning presentations:
✨ 20+ design styles
✨ 6 presentation formats  
✨ Real-world examples
✨ Quick-start guide

Perfect for researchers, creators, entrepreneurs, and educators.

github.com/YOUR-USERNAME/awesome-notebooklm-prompts

#NotebookLM #AI #Presentations

5. Set Up GitHub Pages (Optional)

Make a beautiful landing page for your repository:

  1. Go to Settings → Pages
  2. Set source to main branch
  3. Choose a theme
  4. Your site will be at: YOUR-USERNAME.github.io/awesome-notebooklm-prompts

Updating Your Repository Later

Once your repo is on GitHub, here's how to add updates:

Adding New Prompts

  1. Edit the files locally:

    # Open files, make edits
nano COMPLETE_PROMPTS.md

  2. Commit and push:

    git add .
git commit -m "Add: [description of what you added]"
git push origin main

  3. Your changes appear on GitHub immediately ✨

Accepting Contributions

When people submit pull requests:

  1. GitHub notifies you of new PR
  2. Review the changes
  3. Click "Merge pull request" to accept
  4. The contributor gets credit!

Troubleshooting

"Authentication failed"

"Permission denied (publickey)"

"Cannot push to remote"

  • Make sure you're in the right directory: cd awesome-notebooklm-prompts
  • Check remote URL: git remote -v
  • If wrong, fix it: git remote set-url origin [correct-url]

"README not showing"

  • Make sure the file is named exactly README.md (capital)
  • Commit and push: git add README.md && git commit -m "Fix README" && git push

Files look wrong on GitHub

  • Reload the page (hard refresh: Cmd+Shift+R or Ctrl+Shift+R)
  • Wait a few seconds for GitHub to process

Commands Cheat Sheet

# Initial setup
git init
git add .
git commit -m "Initial commit: message"
git branch -M main
git remote add origin [YOUR-URL]
git push -u origin main

# Daily updates
git add .
git commit -m "Your message"
git push

# Check status
git status
git log --oneline

# View remote
git remote -v

# Undo last commit (before push)
git reset --soft HEAD~1

GitHub Stats (Cool to Watch)

Once your repo is published, GitHub tracks:

  • ⭐ Stars - How many people love it
  • 👀 Watchers - Who's following updates
  • 🍴 Forks - How many people copied it to modify
  • 📊 Traffic - How many visits per day
  • 💬 Discussions - Community conversations
  • 🔔 Issues - Bug reports and feature requests

You can view all this in the "Insights" tab of your repository.

Pro Tips

1. Use Good Commit Messages

✅ GOOD: "Add: Neo-Retro Dev Deck style with specifications"
✅ GOOD: "Improve: Clarify Sharp-Edged Minimalism checklist"
❌ BAD: "update"
❌ BAD: "fix stuff"

2. Create a Release

When you have a stable version:

  1. Go to "Releases" tab
  2. Click "Create a new release"
  3. Tag version (e.g., v1.0.0)
  4. Add release notes
  5. People can download specific versions

3. Add a CHANGELOG

Track changes over time:

## [1.0.0] - 2026-03-24
### Added
- Initial release with 150+ prompts
- 20+ design styles with specifications
- Quick reference guide
- 2 detailed examples

### Changed
- Organized by presentation format

### Fixed
- Improved clarity in prompts

4. Regular Updates

  • Add new prompts as you discover them
  • Fix typos and clarifications
  • Update examples with real results
  • Keep the community engaged

Success! 🎉

You now have:

  • ✅ GitHub repository created
  • ✅ All 150+ prompts published
  • ✅ Beautiful README documentation
  • ✅ Contributing guidelines for others
  • ✅ Ready for the community to discover

Next: Share & Grow

Week 1: Setup & Share

  • Publish to GitHub (you did it!)
  • Share on social media
  • Add GitHub topics
  • Share in communities

Week 2-4: Engagement

  • Respond to questions/issues
  • Add more examples
  • Refine based on feedback
  • Thank contributors

Month 2+: Growth

  • Reach 100 stars
  • Get first community contributions
  • Expand with video tutorials
  • Build community around it

Questions?

If you get stuck:

  1. Check GitHub's own guides: github.com/docs
  2. Search Stack Overflow for your error
  3. Ask in r/github
  4. Check the CONTRIBUTING.md file

Congratulations on publishing! You've created an incredible resource for the community. 🚀

Now go forth and help thousands of creators build stunning presentations with NotebookLM!

Version: 1.0
Last Updated: March 24, 2026