Skip to content

docs: add comprehensive README with features and tech stack#53

Open
moonejon wants to merge 2 commits into
mainfrom
moonejon/add-readme
Open

docs: add comprehensive README with features and tech stack#53
moonejon wants to merge 2 commits into
mainfrom
moonejon/add-readme

Conversation

@moonejon

Copy link
Copy Markdown
Owner

Summary

  • Add a polished, comprehensive README that walks GitHub users through all Penumbra features
  • Include sections for public view features and authenticated user capabilities
  • Add placeholder spots for 7 demo screenshots/GIFs in ./docs/assets/
  • Document the complete tech stack (Next.js 15, React 19, Prisma, PostgreSQL, Clerk, etc.)
  • Include getting started guide, project structure, and key concepts

Highlights

Features Documentation:

  • Public library browsing
  • Book import & cataloging
  • Reading lists & favorites
  • Profile customization
  • Library views (grid/list)
  • Admin settings

Technical Sections:

  • Prerequisites and installation steps
  • Environment variable configuration
  • Database management commands
  • Production data sync instructions
  • Deployment guide for Vercel

Screenshot Placeholders:
The README includes placeholder paths for demo content:

  • ./docs/assets/home-screen-demo.gif
  • ./docs/assets/public-library-view.png
  • ./docs/assets/book-import-demo.gif
  • ./docs/assets/reading-lists-demo.png
  • ./docs/assets/profile-customization-demo.gif
  • ./docs/assets/library-grid-view.png
  • ./docs/assets/admin-settings-demo.png

Test plan

  • Verify README renders correctly on GitHub
  • Add actual screenshots/GIFs to /docs/assets/ directory (follow-up task)

🤖 Generated with Claude Code

Add a polished README that walks users through:
- Public and authenticated features
- Tech stack (Next.js 15, React 19, Prisma, etc.)
- Getting started guide
- Project structure
- Key concepts and database schema

Includes placeholder sections for demo screenshots/GIFs.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 25, 2025

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
penumbra Ready Ready Preview Comment Nov 25, 2025 7:50pm

Replace single screenshots with side-by-side desktop/mobile tables
for all feature sections, making it easy to compare responsive views.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant