-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationtutorial
Description
Overview
Create a comprehensive tutorial page explaining how to add new templates to the template list page. This documentation should be easily accessible from both the root README.md and the /my-templates page.
Documentation Structure
1. Page Location and Links
- Create new file:
docs/tutorials/creating-template.md - Add link in root
README.md - Add link in
/my-templatespage - Add to documentation navigation if exists
2. Tutorial Content Structure
Introduction
# Creating a New Template
This guide will walk you through the process of creating and adding a new template to DappyKit. Templates allow you to share your application patterns with other developers.
## Prerequisites
- DappyKit account
- Basic understanding of web3 applications
- Familiarity with JavaScript/TypeScriptStep-by-Step Guide
-
Accessing Template Creation
- Navigation to template section
- Using the "Create Template" button
- Template creation form overview
-
Template Information
- Required fields explanation
- Name and description best practices
- Category selection
- Tags and searchability
-
Template Configuration
### Template Configuration 1. Basic Information: - Template Name: Choose a descriptive name - Category: Select appropriate category - Description: Write clear, concise description 2. Technical Details: - Framework selection - Required dependencies - Environment variables
-
Code Structure
- Required files
- Directory structure
- Configuration files
- Example implementation
-
Testing Your Template
- Local testing process
- Validation steps
- Common issues and solutions
-
Publishing Process
- Submission guidelines
- Review process
- Publishing timeline
-
Best Practices
- Naming conventions
- Documentation standards
- Code quality requirements
- Security considerations
Examples Section
## Example Template
\`\`\`typescript
// Example template configuration
{
"name": "Simple DApp",
"category": "Web3",
"description": "Basic decentralized application template",
"dependencies": {
"ethers": "^5.0.0",
"web3": "^1.0.0"
}
}
\`\`\`Troubleshooting
- Common issues
- Solutions
- Support channels
Implementation Tasks
- Create tutorial markdown file
- Add navigation links in README.md
- Add navigation links in /my-templates
- Create example template for demonstration
- Add screenshots of the process
- Include code snippets and examples
- Add troubleshooting section
Required Screenshots
- Template creation form
- Field descriptions
- Configuration examples
- Publishing interface
- Success states
Code Examples to Include
- Basic template structure
- Configuration file
- Environment setup
- Deployment scripts
Success Criteria
- Tutorial is clear and comprehensive
- All links are working
- Examples are functional
- Screenshots are up-to-date
- Code snippets are correct
- Navigation is intuitive
Additional Resources Section
- Link to API documentation
- Template examples repository
- Community templates
- Support channels
Timeline
- Writing: 1 day
- Review: 0.5 day
- Implementation: 0.5 day
Notes
- Keep language simple and clear
- Include plenty of examples
- Add tips and best practices
- Consider multi-language support in future
- Include version information
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationtutorial