# Quick Start Guide
## Build & Test Locally
```bash
# Build release binary
cargo build --release
# Binary is at: target/release/git-time-machine
# Test it in this repo
./target/release/git-time-machine
# Or install globally
cargo install --path .
# Then use anywhere
git-time-machine
```
## Create Demo GIF
```bash
# 1. Install recording tools
brew install asciinema
npm install -g @asciinema/agg
# 2. Create a test scenario
git init demo-repo
cd demo-repo
echo "file1" > file1.txt && git add . && git commit -m "commit 1"
echo "file2" > file2.txt && git add . && git commit -m "commit 2"
echo "file3" > file3.txt && git add . && git commit -m "commit 3"
# 3. Record the demo
asciinema rec demo.cast
# In recording:
# - Show: git log --oneline
# - Run: git reset --hard HEAD~2
# - Show: git log --oneline (commits gone!)
# - Run: git-time-machine
# - Navigate to "2m ago"
# - Press Enter
# - Show: git log --oneline (commits back!)
# - Type: exit
# 4. Convert to GIF
agg demo.cast demo.gif --theme monokai
# 5. Add to README
# Replace demo.gif placeholder
```
## Publish to GitHub
```bash
# 1. Create repo on GitHub: dinakars777/git-time-machine
# 2. Push code
git remote add origin https://github.com/dinakars777/git-time-machine.git
git branch -M main
git push -u origin main
# 3. Add topics on GitHub:
# git, tui, rust, cli, reflog, undo, terminal, developer-tools
# 4. Create first release
git tag v0.1.0
git push origin v0.1.0
# 5. Create GitHub Release with:
# - Title: "v0.1.0 - Initial Release 🕰️"
# - Description: Copy from README
# - Attach: target/release/git-time-machine binary
```
## Publish to crates.io
```bash
# 1. Login to crates.io
cargo login
# 2. Publish
cargo publish
# Now anyone can install with:
# cargo install git-time-machine
```
## Launch Checklist
- [ ] Demo GIF created and looks amazing
- [ ] README has demo GIF at top
- [ ] GitHub repo created with topics
- [ ] First release (v0.1.0) published
- [ ] Published to crates.io
- [ ] Tested on clean machine
- [ ] Launch post drafted for HN/Reddit
- [ ] Twitter post drafted with GIF
- [ ] Ready to respond to comments
## Next Steps
1. **Record demo** (most important!)
2. **Push to GitHub**
3. **Publish to crates.io**
4. **Launch on HN/Reddit** (see LAUNCH_STRATEGY.md)
5. **Engage with community**
6. **Ship v0.2** with feedback
---
**Pro tip:** The demo GIF is 80% of success. Make it perfect before launching!