๐ Quickdir Documentation
Welcome to Quickdir!
This documentation will guide you through setup, configuration, customization, and content management for your Quickdir Next.js template. Whether you are a developer or a content editor, youโll find everything you need to launch and maintain your site efficiently.
๐ Getting Started
1. Download and extract project source code
- Download the zip file of the project and unzip it
- Go to the project directory:
cd your-project-directory
2. Install Dependencies
Install all required packages:
yarn install
3. Start the Development Server
Run the following command to start your local server:
yarn dev
Visit http://localhost:3000 in your browser to view your site.
4. Build for Production
To create an optimized production build and preview it locally:
yarn build
yarn preview
โ๏ธ Configuration
All main configuration options are located in src/config/config.json
:
- Site Info:
- Set the site title, base URL, logo, and more in the
site
object.
- Set the site title, base URL, logo, and more in the
- Settings:
- Control features such as search, sticky header, theme switcher, and pagination.
- Params:
- Configure contact form actions, footer text, email, and copyright.
- Navigation Button:
- Enable/disable and set the label/link for the main call-to-action button.
- Metadata:
- Set default meta information for SEO.
๐จ Theme Customization
- Colors & Styles:
- Edit
src/styles/theme.css
to adjust colors, spacing, and other design tokens.
- Edit
- Fonts:
- Change the font family in
src/app/layout.tsx
.
- Change the font family in
- Components:
- For advanced UI changes, edit components in
src/layouts/components/
.
- For advanced UI changes, edit components in
๐ Managing Content
All site content is stored as Markdown files in the src/content/
directory, organized by section:
about/
,authors/
,blog/
,changelog/
,contact/
,homepage/
,pricing/
,products/
,sections/
,submit/
Example: Update the Homepage
Edit src/content/homepage/_index.md
to change the homepage banner, featured products, and more.
Example: Add or Edit a Product
Each product is a Markdown file in src/content/products/
.
To add a new product:
- Copy an existing file (e.g.,
_template.md
). - Update the frontmatter and content.
- Set
draft: false
to publish the product.
๐ ๏ธ Custom Scripts
yarn generate-json
- Generates JSON data from Markdown content. This runs automatically during development and build.
๐ก Additional Tips
- All images are stored in the
public/images/
directory. - SEO and meta tags are managed in
src/layouts/partials/SeoMeta.tsx
. - Review code comments and configuration files for further guidance.
For more information, consult the codebase or reach out to the project maintainers.