Getting Help
Find support, report issues, and connect with the Spry community
Need assistance with Spry? We're here to help! This page outlines the various ways you can get support, report issues, or connect with the Spry community.
Quick Links
GitHub Issues
Report bugs or request features
GitHub Discussions
Ask questions and share ideas
Discord Community
Chat with other users and contributors
Reporting Issues
If you've encountered a bug or unexpected behavior:
Search existing issues
Check if someone has already reported the problem
Gather information
Note your Spry version, Deno version, operating system, and steps to reproduce
Create a detailed report
Include:
- Clear description of the issue
- Steps to reproduce
- Expected vs actual behavior
- Relevant Markdown code snippets or
Spryfile.mdexamples - Error messages or logs
- Screenshots if applicable
Feature Requests
Have an idea to improve Spry?
- Check existing feature requests
- Start a discussion to gather feedback
- Submit a formal feature request
Getting Support
GitHub Discussions
For questions, ideas, and community support, use GitHub Discussions:
- Q&A - Ask questions about using Spry
- Ideas - Share suggestions and discuss potential features
- Show and Tell - Share what you've built with Spry
- General - Everything else related to Spry
Community Chat
Join our Discord server for real-time conversations:
- Get quick answers to questions
- Share tips and tricks
- Connect with other Spry users
- Stay updated on development
Documentation
Before asking for help, check if your question is answered in:
Common Issues
Installation Problems
If you're having trouble installing Spry:
# Ensure you have Deno 2.5+ installed
deno --version
# Run Spry initializer
cd <your-project>
deno run --node-modules-dir=auto -A https://raw.githubusercontent.com/programmablemd/spry/main/lib/sqlpage/cli.ts initSpryfile.md Not Executing
Make sure your code blocks have the correct language identifiers and attributes:
```sql {.store-result}
SELECT * FROM users;
```SQLPage Integration Issues
For SQLPage-related problems:
- Verify your
sqlpage/sqlpage.jsonconfiguration - Check that
dev-src.auto/directory is being generated - Ensure database connection strings are correct
Performance Issues
For large Markdown files or complex workflows:
- Break content into smaller, focused
Spryfile.mddocuments - Use task dependencies efficiently
- Monitor execution with
--watchduring development
Security Issues
Security Vulnerabilities
If you discover a security vulnerability, please do not open a public issue. Instead:
- Email admin+spry@opsfolio.com with details
- Allow us time to address the issue
- We'll credit you in the security advisory (if desired)
See our Security Policy for more information.
Contributing
Want to help improve Spry? See our Contributing Guide to learn how to:
- Set up your development environment
- Submit pull requests
- Follow our coding standards
- Join the core contributor team
Response Times
We're a community-driven project. Expected response times:
| Type | Response Time |
|---|---|
| Critical bugs | Within 24-48 hours |
| General issues | Within 1 week |
| Feature requests | Varies based on complexity and priority |
| Community discussions | Community members typically respond within hours |
Additional Resources
- Changelog - See what's new
- Roadmap - View planned features
- Blog - Read articles and announcements
- Twitter - Follow for updates
Still Need Help?
If you can't find what you're looking for:
- Search our Documentation
- Check GitHub Discussions
- Ask in our Discord community
- Open a GitHub issue as a last resort
Thank you for being part of the Spry community!
How is this guide?
Last updated on