Passa al contenuto principale

Installation

This guide will walk you through setting up the Ever Works on your local machine.

Prerequisites​

Before you begin, ensure you have the following installed:

  • Node.js 20.x or higher - Download here
  • npm, yarn, or pnpm - Package manager
  • Git - For version control
  • PostgreSQL (optional) - For database

System Requirements​

  • Operating System: Windows, macOS, or Linux
  • Memory: 4GB RAM minimum, 8GB recommended
  • Storage: 2GB free space
  • Network: Internet connection for dependencies

Installation Steps​

1. Clone the Repository​

git clone https://github.com/ever-co/ever-works-website-template.git
cd ever-works-website-template

2. Install Dependencies​

Using npm:

npm install

Using yarn:

yarn install

Using pnpm:

pnpm install

3. Environment Setup​

Copy the example environment file:

cp .env.example .env.local

4. Configure Environment Variables​

Edit .env.local with your configuration:

# Basic Configuration
NODE_ENV=development
NEXT_PUBLIC_API_BASE_URL="http://localhost:3000/api"

# Authentication
AUTH_SECRET="your-secret-key"  # Generate with: openssl rand -base64 32
NEXTAUTH_URL="http://localhost:3000"

# Database (Optional)
DATABASE_URL="postgresql://user:password@localhost:5432/everworks"

# GitHub Integration (Required for content sync)
GH_TOKEN="your-github-token"
DATA_REPOSITORY="https://github.com/ever-works/awesome-data"

5. Generate Auth Secret​

Generate a secure secret for authentication:

openssl rand -base64 32

Copy the output and set it as your AUTH_SECRET in .env.local.

6. Database Setup (Optional)​

If you want to use a database:

# Generate database schema
npm run db:generate

# Run migrations
npm run db:migrate

# Seed initial data
npm run db:seed

7. Start Development Server​

npm run dev

Your application will be available at http://localhost:3000.

Verification​

To verify your installation:

  1. Check the homepage - Navigate to http://localhost:3000
  2. Test content sync - Items should load from the data repository
  3. Check authentication - Try signing in (if configured)
  4. Verify API - Visit http://localhost:3000/api/version

Common Issues​

Port Already in Use​

If port 3000 is already in use:

npm run dev -- -p 3001

Permission Errors​

On macOS/Linux, you might need to use sudo for global installations:

sudo npm install -g <package-name>

Node Version Issues​

Use Node Version Manager (nvm) to switch Node versions:

nvm install 20
nvm use 20

Next Steps​

Now that you have the template installed:

  1. Configure your environment properly
  2. Follow the Quick Start Guide to customize your site
  3. Set up authentication providers
  4. Configure payment processing

Getting Help​

If you encounter issues: