Frequently Asked Questions
Find answers to common questions about jam-gen
General
jam-gen is a modern JAMstack static site generator built on Astro with React support. It compiles Markdown content into static HTML with selective JavaScript hydration for optimal performance.
jam-gen is designed for developers, bloggers, and teams who want fast, SEO-friendly static sites with Markdown-based content management, multiple theme support, and Docker containerization for CI/CD.
Yes! jam-gen is open source and free to use for any project, personal or commercial.
Technical
jam-gen is built with Astro for static site generation, React for interactive components, Panda CSS for zero-runtime styling, and TypeScript for type safety throughout.
You can customize themes by editing colors in site.json, switching themes with npm run dev --theme=noir, or creating custom themes in src/themes/.
Absolutely! Add Astro or React components to src/components/ and import them in your pages or layouts. React components can be used as interactive islands with client directives.
jam-gen includes three themes: Minimalist (clean, content-focused), Noir (dark developer theme), and Bold (neubrutalist with hard shadows). Switch with npm run theme:noir or npm run theme:bold.
Deployment
Run npm run build to generate static files in the dist/ directory. For a specific theme, use npm run build --theme=noir.
Yes! jam-gen includes a Dockerfile for containerized builds. Build with docker build -t jam-gen . and run with volume mounts for content and output.
jam-gen generates static files that can be deployed anywhere: Vercel, Netlify, GitHub Pages, AWS S3, Cloudflare Pages, or any static hosting service.